home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / wordproc / raved110.arj / RE.DOC < prev    next >
Text File  |  1993-08-12  |  130KB  |  2,228 lines

  1.  
  2.  
  3.                                   Ravitz Editor  1.10
  4.  
  5.                          ASCII text editor for IBM/DOS systems
  6.  
  7.                       (C) Copyright Ravitz Software Inc. 1989,1993
  8.  
  9.          Ravitz Software Inc.                              BBS/FAX 606-268-0577
  10.          P.O. Box 25068
  11.          Lexington, KY  40524-5068
  12.          USA                                  Compuserve Cary Ravitz [70431,32]
  13.  
  14.  
  15.          Introduction ....................................................... 2
  16.          License                                                              3
  17.          Installation ....................................................... 3
  18.          General Information                                                  4
  19.          Help ............................................................... 6
  20.          Entering Text                                                        6
  21.          Functions .........................................................  7
  22.          Commands                                                            10
  23.          Menus ............................................................. 11
  24.          Edit Command                                                        12
  25.          Save Command ...................................................... 13
  26.          Quit Command                                                        14
  27.          Name Command ...................................................... 14
  28.          Print Command                                                       14
  29.          Marking An Area ................................................... 15
  30.          Operating On An Area Mark                                           17
  31.          Fill Area Functions ............................................... 19
  32.          Line Exclude Functions                                              20
  33.          Position Mark Functions ........................................... 24
  34.          Word Wrap Margins Command                                           25
  35.          Tab Command ....................................................... 25
  36.          Basic Flow Functions                                                26
  37.          Paragraph Reflow Functions ........................................ 28
  38.          Drawing Modes                                                       28
  39.          Find Command ...................................................... 29
  40.          Change Command                                                      31
  41.          Order Lines Command ............................................... 32
  42.          Line Number Command                                                 32
  43.          Trash Buffer ...................................................... 33
  44.          Dos Shell Command                                                   33
  45.          Windows and Split Screen .......................................... 34
  46.          Status Line                                                         34
  47.          File and Device Names ............................................. 35
  48.          Memory Management                                                   35
  49.          Housekeeping Details .............................................. 36
  50.          Mouse Handling                                                      37
  51.          Displays .......................................................... 37
  52.          Tips                                                                38
  53.          Messages .......................................................... 39
  54.          RBIN                                                                43
  55.          Compatibility and Technical Information ........................... 44
  56.          What RE Cannot Do                                                   46
  57.          User Support ...................................................... 47
  58.  
  59.                                                                             p-2
  60.          Introduction ---------------------------------------------------------
  61.  
  62.            Ravitz Editor (RE) is an ASCII text editor for IBM/DOS computers. It
  63.            is  mid  sized (46K to  64K)  but  very  powerful,  with  integrated
  64.            outlining and overviewing.
  65.  
  66.            RE has organizational aids that let you hide (exclude) lines to view
  67.            and operate  on  program,  outline,  and  document structures,  sort
  68.            lines, mark and return to positions, and  view two files or parts of
  69.            the same file at once.  A change tracking system lets you review new
  70.            and modified lines, and a trash buffer lets  you recover deleted and
  71.            changed lines.
  72.  
  73.            The user interface includes features such as: one character mnemonic
  74.            functions,  commands,  and  options;  menus;  mouse  input;  and  an
  75.            internal instant help system.
  76.  
  77.            RE  includes  find and change functions  with  options such as word,
  78.            ignore excluded lines, look only  in marked area, all, and show all.
  79.            Its marked area functions include overlay, copy lines,  delete, fill
  80.            with  block  pattern,  fill  with  line  pattern,  uppercase,  shift
  81.            horizontal, and shift vertical.  Each of these functions may include
  82.            or ignore  excluded  lines.  There  are  also functions  to help  in
  83.            writing  documents  such  as  word   wrap,  flow,  flow  with  right
  84.            justification, flow into list, and line drawing.
  85.  
  86.            RE is configurable via profiles that are installed  within  the  EXE
  87.            file.  Keyboard usage,  default values,  macros,  menus, panels, and
  88.            help text may be  defined  with a  profile and assembled  into a new
  89.            RE.EXE  with REPROF.  The macro facility  has nestable  macros  with
  90.            looping  and   conditional   control.   See  REPROF.DOC   for   more
  91.            information.                                                        
  92.  
  93.                                                                             p-3
  94.          License --------------------------------------------------------------
  95.  
  96.            Ravitz Editor is  provided as is.  There are no warranties expressed
  97.            or implied.
  98.  
  99.            You may use  Ravitz Editor  version 1.10 without charge.  No further
  100.            development  of RE is planned, however if  new versions are released
  101.            they may require a registration charge for use.
  102.  
  103.            You may distribute  RE if  you  keep the  entire  package  together,
  104.            unchanged, including this  license  explanation, and  do  not charge
  105.            more than $10.  You may include special profiles if they are clearly
  106.            marked as such.
  107.  
  108.          Installation ---------------------------------------------------------
  109.  
  110.            The RE package consists of these files:
  111.  
  112.              RE.EXE      program (not included - must be generated with REPROF)
  113.              RE.DOC      documentation
  114.              REPROF.EXE  profile assembler program
  115.              REPROF.DOC  profile documentation
  116.              REPROF.1    default profile
  117.              REPROF.2    alternate profile
  118.              REPROF.MAC  miscellaneous macros
  119.              RBIN.EXE    binary file handler utility
  120.              README.*    quick information
  121.  
  122.            To  install RE  copy the distribution  files to your working disk or
  123.            directory.  Run  "REPROF" from  the  DOS  prompt.  This  will create
  124.            RE.EXE.
  125.  
  126.            RE.EXE is a stand alone executable file.  You can use it without any
  127.            other file - help text is included within the EXE file.
  128.  
  129.            RE.DOC is  this manual.  You  will need it for in-depth explanations
  130.            that are  not included in the program  help text.  You  can print it
  131.            with "COPY RE.DOC PRN" (49 pages).
  132.  
  133.            REPROF.EXE  is the profile assembler.  It  assembles  a  profile  to
  134.            create a new RE.EXE,  and can also regenerate the  original  RE.EXE.
  135.            REPROF.1 and REPROF.2  are  profiles  that can  be  used as starting
  136.            points  for  your  personalization   of   RE.   REPROF.DOC  is   the
  137.            documentation, which  may be printed with "COPY REPROF.DOC PRN"  (41
  138.            pages).
  139.  
  140.            REPROF.MAC is a set of macros that may be useful.
  141.  
  142.            RBIN.EXE is a binary  file handler utility that runs from inside RE.
  143.            This file is not required to use RE.
  144.  
  145.            The README.* files are not needed to run RE, but they must accompany
  146.            the rest of the files if you distribute the package.                
  147.  
  148.                                                                             p-4
  149.          General Information --------------------------------------------------
  150.  
  151.            The  general flow of RE is: start the program; load a disk file into
  152.            memory  or start with no data; update the in-memory data; and output
  153.            the data to disk.
  154.  
  155.            To start RE from the DOS prompt, type RE and press enter.  This will
  156.            start with an empty  file.  If you prefer to start with an old file,
  157.            type RE and the file name at the DOS prompt.  The display must be in
  158.            80 (or greater) column mode or RE will not start. If this is not the
  159.            case, use the  DOS MODE command  to set it (MODE CO80, MODE BW80, or
  160.            MODE MONO).
  161.  
  162.            To  save your  data and exit from RE, use  the S (Save) and Q (Quit)
  163.            commands, described below.
  164.  
  165.            You interface with RE in one of four ways.  The first way is through
  166.            the letter and number keys. The screen and computer memory will echo
  167.            your input at the cursor location.  The cursor is  seen as a  bright
  168.            block behind a character or a  highlighted underscored character (on
  169.            a digital monochrome display).
  170.  
  171.            The second way is through function keys.  These keys perform various
  172.            often used functions.  They  include the  cursor movement  keys, the
  173.            enter, insert, and delete keys, many alt and  ctrl shifted keys, and
  174.            others.  These  keys  and  their  functions  are  described  in  the
  175.            FUNCTIONS section.  To  get started,  try the  alt-n key (for  a new
  176.            line)  and the  cursor movement keys.  Some function keys do  two or
  177.            three   functions,  sometimes  depending   on  cursor   position  to
  178.            distinguish which function  to do  and  sometimes requiring multiple
  179.            presses to  do a specific function.  Examples are split line  / join
  180.            lines and center / left side / right side. This minimizes the number
  181.            of keys that you need to remember.
  182.  
  183.            The third way  is  through commands.  You enter commands  on the top
  184.            line of the screen  (the command  line) and execute them by pressing
  185.            the enter key.  They  include functions that  require  the entry  of
  186.            names, numbers,  or options.  Examples are edit a file, save a file,
  187.            and find  a  string.  These  are  described in the COMMANDS section.
  188.            Important commands for getting started are: E file to edit a file; S
  189.            to save a file; and Q to quit.
  190.  
  191.            The fourth way is  menus.  When a menu is displayed you can move the
  192.            selection  bar to any item with  the cursor keys and select the item
  193.            with the enter key.  If one of the letters in an item is capitalized
  194.            then that item can be immediately  selected  by pressing the letter.
  195.            Esc backs  out of the menu and PgUp and PgDn display the previous or
  196.            next  menu.  Menu functions are  referred to  here with the key that
  197.            displays  the  menu  followed   by  the  item   name,   for  example
  198.            f2-Directory.
  199.  
  200.            RE is described in this manual but  the  best way to learn RE is  by
  201.            using it.  If an explanation is not  clear, please try the function.
  202.            Do not be afraid to experiment.                                     
  203.  
  204.                                                                             p-5
  205.            A short RE session to  create a  new file looks like this.  Function
  206.            keys are enclosed in "(" and ")". From DOS:
  207.  
  208.              re program.pas (enter)          start with an empty file
  209.              (csr dn) (csr dn)               move cursor to first blank line
  210.              program add; (enter)            enter text
  211.              var i: integer; (enter)         .
  212.              begin (enter)                   .
  213.              i:=16+4; (enter)                .
  214.              end.                            .
  215.              (esc) s (enter)                 save file to program.pas
  216.              q (enter)                       return to DOS.
  217.  
  218.            A short session to modify this file looks like this. From DOS:
  219.  
  220.              re program.pas (enter)          start RE and read file
  221.              (csr dn) (csr dn) (csr dn)      move cursor
  222.              (csr rt) (csr rt) (csr rt)      .
  223.              (csr rt) (csr rt)               .
  224.              (ins)                           toggle to insert mode
  225.              ,j                              insert new text
  226.              (csr dn) (csr dn) (alt-n)       move cursor and insert new line
  227.              j:=i+6;                         enter text
  228.              (esc) sq (enter)                save file to program.pas and quit.
  229.  
  230.                                                                             p-6
  231.          Help -----------------------------------------------------------------
  232.  
  233.            RE's help system is invoked with f1-Help_system or alt-f1.  The help
  234.            item on  each  menu and alt-f1  from a menu start the help system on
  235.            the page specific to the menu.
  236.  
  237.            The help  system may be paged  through with pgup, up, pgdn, and down
  238.            or any specific page may be selected with  its page  letter.  Esc or
  239.            alt-f1 backs out of the help system.
  240.  
  241.            The help system has explanations  for RE's functions  and it will be
  242.            useful  to  help learn  and  use  RE.  But  it does not replace this
  243.            reference.
  244.  
  245.          Entering Text --------------------------------------------------------
  246.  
  247.            You  enter text in RE just like most other programs - text is echoed
  248.            at  the cursor position and the  cursor is moved in preparation  for
  249.            the next character.  There are a few devices that help  to make room
  250.            for your text.  These only work in the text area, not on the command
  251.            line.  The first is  word wrap, which  is a common feature that lets
  252.            you enter text continuously. The word wrap feature inserts new lines
  253.            and  moves words that cross the margins so that the text fits within
  254.            the margins.  See  WORD  WRAP MARGINS COMMAND  to set the  word wrap
  255.            margins.
  256.  
  257.            RE  does word wrap only when you type a character in the  right word
  258.            wrap column  and  then  type  another  character.  After  the  first
  259.            character  has been  entered,  a  "w"  appears on  the  status line.
  260.            Anything other than a character cancels the word wrap.  The new line
  261.            caused by  a word wrap starts in the left word wrap column.  You are
  262.            not prevented from entering text outside the word wrap margins.
  263.  
  264.            In  the word wrap state (after entering a character in the word wrap
  265.            column), if the right word  wrap column is at the edge of the screen
  266.            then the cursor does not make its usual move, but if you continue on
  267.            and cause the word wrap then the cursor  is adjusted before entering
  268.            the next character.  This lets you keep the right margin at the edge
  269.            of the screen.
  270.  
  271.            RE does an automatic horizontal screen scroll when  two  consecutive
  272.            characters  are typed at the right  edge of  the screen.  After  the
  273.            first character is  entered, an "s" appears  on the  status line and
  274.            the cursor does not move. The second character will follow the first
  275.            after the scroll.
  276.  
  277.            When you enter a character on  the "Top ---" or "Bottom ---" line, a
  278.            new line is automatically inserted and  the cursor is  moved to that
  279.            line before the character is entered.                               
  280.  
  281.                                                                             p-7
  282.          Functions ------------------------------------------------------------
  283.  
  284.            A function is executed by pressing its  associated  key or selecting
  285.            the appropriate  menu  item.  The  following  is a list  of  labeled
  286.            function  keys.  The  use of these keys is generally compatible with
  287.            their use in other programs.
  288.  
  289.              The cursor movement keys (arrow keys) move the cursor one space in
  290.              the  direction indicated by the arrows.  The cursor skips over the
  291.              status  line  (line  2),  and  wraps  around  the  screen  in  all
  292.              directions. In typematic mode, horizontal cursor movement is three
  293.              spaces at a time.
  294.  
  295.              The home key (or  f4-Start_of_line) moves the cursor to  the first
  296.              nonblank character on a  line.  On a blank line the cursor will be
  297.              moved to column 1. If the target column is off the current screen,
  298.              the screen will scroll to show the cursor.
  299.  
  300.              The end key  (or  f4-End_of_line)  moves the cursor to  the  space
  301.              after the last nonblank character on a line.  On a blank line, the
  302.              cursor  will be moved  to column  1.  The screen will  scroll,  if
  303.              needed, to show the cursor.
  304.  
  305.              The forward and backward tab keys move the cursor to the  next and
  306.              previous tab position.  The screen will scroll, if needed, to show
  307.              the  cursor.  The  tab  positions  are  set  with  the T  command,
  308.              described in the TAB COMMAND section. These keys do not insert tab
  309.              characters or blanks in the file. They only move the cursor.
  310.  
  311.              The backspace key deletes the character to the left of the  cursor
  312.              and moves everything that is on and to the right of the cursor one
  313.              space left. The screen will automatically scroll if needed.
  314.  
  315.              The  delete  key deletes the character at the  cursor position and
  316.              moves  everything  that is  to  the right  of the cursor one space
  317.              left.
  318.  
  319.              Caps lock toggles between caps lock mode and lowercase mode.
  320.  
  321.              The insert key toggles between replace and insert mode. In replace
  322.              mode text keys replace the character at the cursor. In insert mode
  323.              text keys insert characters at the cursor, pushing the rest of the
  324.              line to the right.
  325.  
  326.              The  escape key toggles the cursor  between the text  area and the
  327.              command line.  If the cursor is in the text  area then it is moved
  328.              to the start of the command line.  If the cursor is on the command
  329.              line then it is moved to its  last position in the text area or as
  330.              close to  that  position as possible without scrolling the screen.
  331.              The cursor can  also be moved  on or off the command line with the
  332.              cursor up and down keys.                                          
  333.  
  334.                                                                             p-8
  335.              The  enter key either executes  a command or moves the  cursor  to
  336.              column 1 of the next line and scrolls the screen  to column 1.  If
  337.              the cursor is on the command line and the command line is nonblank
  338.              then enter executes the command. If the cursor is in the text area
  339.              and the first nonblank character on the  command line is 'F', 'f',
  340.              'C', or  'c' then enter  executes  the  command.  Otherwise  enter
  341.              causes the cursor return function described above.
  342.  
  343.              The page up key (or f4-scroll_Up) scrolls the screen view up.  The
  344.              number of lines scrolled is such  that  the cursor is moved to the
  345.              bottom  of  the  screen or one full  screen minus  one line if the
  346.              cursor is already at the bottom or on the command line.
  347.  
  348.              The  page down key (or f4-scroll_Down) is similar to page  up, but
  349.              it moves the screen view down.
  350.  
  351.              The ctrl-backspace key  (or  f1-delete_line)  deletes the  current
  352.              line. This will not work on an excluded line. On the command line,
  353.              ctrl-backspace blanks the line.
  354.  
  355.              The  ctrl-home and ctrl-end keys (f4-Top_of_file,  f4-Bot_of_file)
  356.              scroll to the top and bottom of a file.
  357.  
  358.              The ctrl-left and ctrl-right keys (f4-scroll_lf_1, f4-scroll_rt_1)
  359.              scroll the screen view left and right one column.
  360.  
  361.              The  ctrl-page  up  and  ctrl-page   down   keys  (f4-scroll_up_1,
  362.              f4-scroll_dn_1) scroll the screen view up and down one line.
  363.  
  364.              The  break key  (ctrl-break on a PC or fn-break on a PCjr) cancels
  365.              printing, sorts, finds, changes, and macros.  No other function in
  366.              RE is interruptible.
  367.  
  368.            All other function keys are obtained by pressing and holding the alt
  369.            key and then pressing one of the letter or number keys.
  370.  
  371.              Alt-a (f1-Ascii_code) lets you enter an ASCII code. After pressing
  372.              alt-a,  enter three digits, representing a number from 0  to  255.
  373.              You  must  enter  three digits.  Use leading zeros to  get numbers
  374.              below 100.  The character represented by this code will  be put in
  375.              your file as if you had  typed  it.  The alt-a function  lets  you
  376.              enter characters  that, if  typed from the keyboard,  would  cause
  377.              various RE functions rather than  being interpreted as characters.
  378.              For  example,  ASCII 13 is interpreted  as  the  enter key, but by
  379.              entering  alt-a 013, you  may put it  in your file.  (note: Do NOT
  380.              press alt while entering your ASCII  code, and if  you wish to use
  381.              the numeric keypad instead of the top row numbers you must use the
  382.              shift key or be in num lock mode.)
  383.  
  384.              Alt-e (f2-Edit_file) edits a file in a new edit session.  The file
  385.              name is specified by the cursor position.  The cursor must be on a
  386.              character in the  file  name, and  the file name  is  delimited by
  387.              blanks or the  left or right end of the  line.  This function puts
  388.              the corresponding edit command  on  the command line and therefore
  389.              destroys any text on the command line.                            
  390.  
  391.                                                                             p-9
  392.              Alt-h  (f3-Highlight_csr) highlights the  cursor  by causing it to
  393.              blink.  The highlighting will disappear after 10 blinks or at  the
  394.              next keystroke.
  395.  
  396.              Alt-k (f1-Erase_end_line) erases from the cursor to the end of the
  397.              line.
  398.  
  399.              Alt-n (f1-New_line) adds a new blank line below the cursor.
  400.  
  401.              Alt-q (f2-Next_session) moves the screen to the  next edit session
  402.              in the session ring.
  403.  
  404.              Alt-r  (f1-Reshow) redisplays the current  line from  the  data in
  405.              memory,  if the cursor is on a  text line.  If  the cursor is on a
  406.              group of excluded lines, then these lines are shown (unexcluded).
  407.  
  408.              Alt-s (f1-Split/join) is  the  split/join function.  If  you press
  409.              alt-s and  there are nonblank characters on or to the right of the
  410.              cursor, then the line will  be split at the cursor position.  This
  411.              includes  characters  that  have been pushed off  the right of the
  412.              screen. If there are only blanks on and to the right of the cursor
  413.              then the line below the current line will be joined to the current
  414.              line at the cursor position. Leading blanks on the joined line are
  415.              removed.  If a line to be  joined will not fit, you  will  get  an
  416.              incorrect cursor position message.
  417.  
  418.              Alt-y (f3-Recall_cmd_up) moves the cursor to the command  line and
  419.              recalls  commands.   Your  last   sixteen   commands   are  saved.
  420.              Consecutive presses of alt-y restores them in reverse order.
  421.  
  422.              Alt-- (alt dash)  (f4-scroll_Left) scrolls  the  screen view left,
  423.              such that the current cursor column is moved to right  edge of the
  424.              screen.
  425.  
  426.              Alt-= (f4-scroll_Right)  scrolls the screen view right,  such that
  427.              the current cursor column is moved to screen column 1.
  428.  
  429.              Alt-7 (f4-up_outline) moves  the cursor up  to the  next line that
  430.              starts on or to the left of the cursor.
  431.  
  432.              Alt-8  (f4-down_outline) moves  the cursor  down to the  next line
  433.              that starts on or to the left of the cursor.
  434.  
  435.            There  are  more  functions described  in  the sections on  area and
  436.            position marks, the find and  change commands, the exclude and  flow
  437.            functions,  line drawing function,  windows,  memory management, and
  438.            help.                                                               
  439.  
  440.                                                                            p-10
  441.          Commands -------------------------------------------------------------
  442.  
  443.            Enter commands on the top line of the screen  (this is also referred
  444.            to as the command line). The esc key is a convenient way to move the
  445.            cursor  to the  command line.  The command will be executed when you
  446.            press the enter key.  If the cursor is on  the  command line and the
  447.            command line  is nonblank then  enter executes  the command.  If the
  448.            cursor is in  the data area and the first  nonblank character on the
  449.            command line is  'F', 'f',  'C',  or 'c'  then  enter  executes  the
  450.            command. Otherwise enter causes the cursor return function.
  451.  
  452.            The  length of the command line is the width of the screen.  It does
  453.            not scroll.
  454.  
  455.            In the  command  descriptions here  "("  and  ")"  enclose  optional
  456.            parameters.  "/"  separates  mutually  exclusive parameters.  Option
  457.            characters may follow the command or may be attached  to the command
  458.            character ("S file Q" is the same as "SQ file").
  459.  
  460.            The RE commands are:
  461.  
  462.              C - change            - see CHANGE COMMAND
  463.              D - DOS shell         - see DOS SHELL COMMAND
  464.              E - edit              - see EDIT COMMAND
  465.              F - find              - see FIND COMMAND
  466.              N - name              - see NAME COMMAND
  467.              O - order lines       - see ORDER LINES COMMAND
  468.              P - print             - see PRINT COMMAND
  469.              Q - quit              - see QUIT COMMAND
  470.              S - save              - see SAVE COMMAND
  471.              T - tabs              - see TAB COMMAND
  472.              W - word wrap margins - see WORD WRAP MARGINS COMMAND
  473.              n - line number       - see LINE NUMBER COMMAND.                  
  474.  
  475.                                                                            p-11
  476.          Menus ----------------------------------------------------------------
  477.  
  478.            RE has 10  menus, accessed with f1 through f10.  Menus 2 through  10
  479.            may also  be  accessed from the  first  menu.  Help for each menu is
  480.            available from the "help" item.
  481.  
  482.            When a menu  is  displayed you can  move the  bar cursor to any item
  483.            with  the cursor keys and select the item with enter.  If one of the
  484.            letters in an item is capitalized then that item can be selected  by
  485.            pressing the letter key. Esc backs out of the menu and pgup and pgdn
  486.            display the previous and next menu.
  487.  
  488.            Each  menu  item  represents  an  RE  function,  command,  or  macro
  489.            (sequence of functions).  If the function is available directly from
  490.            a keystroke  then the key is noted with a "<" ("Split/join <a-s" can
  491.            also be invoked with the alt-s key).
  492.  
  493.            If a  menu  item  includes  a  *  then that item initializes  an  RE
  494.            command.  The * represents a string that  you  must enter (such as a
  495.            file name).  To execute the  command press the enter  key.  ("dir_*"
  496.            puts  "ed " on the command line and returns control to  you.  If you
  497.            enter *.pas and press enter you will get a list of .pas files).
  498.  
  499.            If an  item  is marked with  a diamond then  it represents a complex
  500.            macro that may remove your current area mark or pending command.
  501.  
  502.            Displaying (or  escaping  from) a menu does  not change the state of
  503.            RE.  Any displayed message  remains and  any transient  state stays.
  504.            Selecting an item is the same as using a function key.
  505.  
  506.            The Basic menu (f1) lets you select any other menu, the help system,
  507.            or the basic editing functions such as split/join and new line.
  508.  
  509.            The File, Print, DOS  menu (f2  or f1-File,print,dos) includes edit,
  510.            save, quit, session selection, print, and DOS shell functions.
  511.  
  512.            General (f3 or f1-General) has  general functions including  marking
  513.            an area or position, draw mode, and command recall.
  514.  
  515.            Position (f4 or  f1-Position) has functions  that  let you  set  the
  516.            cursor and screen position.
  517.  
  518.            Exclude (f5 or f1-eXclude) has line exclude functions.
  519.  
  520.            Document  Processing  (f6  or  f1-Document_proc)  contains  document
  521.            processing function such as flow, margins, tabs, date, and time.
  522.  
  523.            Find/Change (f7 or f1-fInd/change) has find and change functions.
  524.  
  525.            Modify Mark  Contents  (f8  or  f1-Mod_mk_contents)  has  area  mark
  526.            functions  that modify  the  contents  of  a mark such as  shifting,
  527.            centering, and uppercase.
  528.  
  529.            Copy,  Delete, Fill  Mark (f9 or f1-Copy,del,fill_mk) has area  mark
  530.            functions that copy, overlay, delete, or fill the mark.
  531.  
  532.            Order Lines (f10 or f1-Order_lines) contains line sorting functions.
  533.  
  534.                                                                            p-12
  535.          Edit Command ---------------------------------------------------------
  536.  
  537.            "E (file (C/G)(D)(N/T))" starts a new edit session  and reads in the
  538.            specified   file  (example:  E  PROGRAM.PAS  lets   you   edit  file
  539.            program.pas).  The file  name  may  be a complete DOS file name with
  540.            disk  and path  names (see  FILE  AND  DEVICE NAMES  for  a complete
  541.            description of RE's file name criteria).  The C option says to check
  542.            for  a matching file name in  the  current files, and if found go to
  543.            that  session or if not found start  a new session and  read in  the
  544.            file.  The G option is like the C  option except it will fail if the
  545.            file is not already in the session ring (G means go to file).  The N
  546.            option says to  handle tabs characters as normal characters.  The  T
  547.            option says to expand tab characters on input (this is the default).
  548.            Tab characters that would cause a line to exceed  255 characters are
  549.            not expanded, and cause a line(s) too long message.
  550.  
  551.            If the D option is chosen then instead of reading a file, RE creates
  552.            a  directory list.  The specified file name is  used as  a  mask  to
  553.            screen files for inclusion in the list. If there is no "*" or "?" in
  554.            the file then "\*.*" or "*.*" is added to create the mask.  If the D
  555.            option is not chosen but the file (not the path) contains either "*"
  556.            or "?"  or ends  with "\" or  ":" then the D option is assumed.  The
  557.            file names in the directory list are sorted alphabetically (this can
  558.            be  turned off - see @SORTDIR in REPROF.DOC).  Subdirectories in the
  559.            file list are followed by "\*.*" and  are sorted  to the top of  the
  560.            list.  Time  and date formats  are  configurable (see  @TIMEFORM and
  561.            @DATEFORM). The file attributes are listed as "a" - archive bit set,
  562.            "r" - read only, "h" - hidden,  and "s" - system.  Hidden and system
  563.            files  are normally not shown but may be included (see @SHOWHIDSYS).
  564.            Alt-e  may be used to edit a file or subdirectory from a  file list.
  565.            An edit session with a directory list is the same as an edit session
  566.            with a file except the name on the status lines is not  a valid name
  567.            to  save the session to.  The files names may be used as a selection
  568.            list or may be used to create BAT files that act on the files.
  569.  
  570.            To find a match, the C and G options require an exact match. This is
  571.            easily tricked because  a  given  file  may  be  specified  in  many
  572.            different  ways  (temp  is  the  same  as  temp.   or  c:temp).  The
  573.            @exfilename  patch lets  you  standardize file  names  to  make this
  574.            option much more difficult to trick. However, since DOS lets you use
  575.            various utilities to refer to a given file with different names, the
  576.            C  option  will never  be  foolproof.  The @edcurfl patch  lets  you
  577.            default to the C option.
  578.  
  579.            Alt-e or  f2-Edit_file edits the file that  the  cursor is on.  This
  580.            lets you pick a file or subdirectory from a directory list.
  581.  
  582.            F2-Directory edits a list of files in the current directory. This is
  583.            the same as the command "E *.*" or "ED".
  584.  
  585.            F2-edit_* sets up an edit  command  and f2-dir_* sets up a directory
  586.            list command.                                                       
  587.  
  588.                                                                            p-13
  589.          Save Command ---------------------------------------------------------
  590.  
  591.            "S  (file (Q)(B/D/I)(T/N))"  saves the  data  for the  current  edit
  592.            session  (example: S  PROGRAM.PAS saves the  current  data  to  file
  593.            program.pas,  regardless  of  the displayed  file name, S  saves the
  594.            current  data  to the  displayed  file).  The default  file name  is
  595.            displayed on the status line. You may substitute a * for the file to
  596.            refer to the displayed file.
  597.  
  598.            The Q  option  is the same as a Save command and then a Quit command
  599.            except that  the message resulting  from  a successful save  appears
  600.            after the quit is finished.  If the save is not successful, then the
  601.            quit is not done.
  602.  
  603.            The process  used by RE  for saving a file to a file that exists  if
  604.            the B  (Backup) option is chosen or if no save type option is chosen
  605.            is:  delete the file with extension BAK;  save the data to file with
  606.            extension  RE!; rename  the original file with extension BAK; rename
  607.            the  file with extension RE!  to  specified  file  name.  If  the  I
  608.            (Indirect) option  is  chosen then  the process  is: save  to  .RE!;
  609.            delete  the  original file; and rename  .RE!  to  the specified file
  610.            name.  If the D (Direct) option  is chosen then  the file is written
  611.            directly.  This is not  as safe as the other  save types because the
  612.            original file is destroyed before the new one is written.
  613.  
  614.            When  saving  to  a  file  that does not exist, the  save  is always
  615.            directly to that file.
  616.  
  617.            The T  option  says  to  compress the  file  with tab  characters on
  618.            output.  The  N  option  (the  default)  says  to  not  do  any  tab
  619.            compression.
  620.  
  621.            The  Save command does not handle devices correctly (in general), so
  622.            if you  want  to write to a device instead of a file, use  the Print
  623.            command.
  624.  
  625.            F2-Save, and f2-sAve_+_quit invoke the S and SQ commands.
  626.  
  627.            Some hardware /  software setups (especially with disks formatted to
  628.            more than 32M) give very  slow saves with  RE's safe save system due
  629.            to very  slow file renames.  Using the D option should speed this up
  630.            considerably.   D  can  be  made  the  default,  see  @DEFSAVETP  in
  631.            REPROF.DOC.                                                         
  632.  
  633.                                                                            p-14
  634.          Quit Command ---------------------------------------------------------
  635.  
  636.            "Q" cancels an edit session WITHOUT saving  the  data.  If you  have
  637.            changed the data since your last save, then you will be prompted for
  638.            confirmation of the Quit command.  If there is only one edit session
  639.            then RE is ended and you will receive the DOS prompt.
  640.  
  641.            F2-Quit does a Quit command.
  642.  
  643.          Name Command ---------------------------------------------------------
  644.  
  645.            "N file" resets the session file name. No change is made to any disk
  646.            file.  Only the default file  name,  used  by  the Save command  and
  647.            displayed  on the status line, is changed.
  648.  
  649.            The Name command checks  file  name validity and does not  allow the
  650.            standard DOS device  names but does not prohibit other  device names
  651.            or nonexistant paths. These will be caught only when you try to save
  652.            the file.
  653.  
  654.            F2-name_* sets up a Name command.
  655.  
  656.          Print Command --------------------------------------------------------
  657.  
  658.            "P (file/device (M)(X))" prints the current file, or an area mark in
  659.            the current file  if the M option is specified, to a file or device.
  660.            PRN,  the default DOS printer, is the default device.  LPT2 and LPT3
  661.            print  to the second and  third printers.  The X option says  to not
  662.            print   excluded   lines.   Break  cancels   printing  at  the  next
  663.            opportunity.
  664.  
  665.            When  printing to a printer or device,  after printing each line, RE
  666.            sends a carriage return and line  feed (ASCII 13, 10) to the printer
  667.            except if the last character of the last line printed is a form feed
  668.            (ASCII 12) then the line feed is suppressed.
  669.  
  670.            If you specify a file then the data  is  written  directly,  without
  671.            checking  for available disk space or making a backup.  If the Print
  672.            command  is successful then the new file is the same  as if  it  had
  673.            been created with a Save command.
  674.  
  675.            F2-print,  f2-print_mark,   f2-print_unex_mark   invoke   the  Print
  676.            command.                                                            
  677.  
  678.                                                                            p-15
  679.          Marking An Area ------------------------------------------------------
  680.  
  681.            To  define  areas  on which  to  do several  functions, RE uses area
  682.            marks.  These marks define rectangular areas of text.  Only one area
  683.            mark may exist at any time.
  684.  
  685.            To use an area mark function,  you  must first mark an area of text.
  686.            There are many ways to do this.
  687.  
  688.              Mark a character with alt-b or f3-mark_Block.
  689.  
  690.              Mark two corners of a block with alt-b or f3-mark_Block.
  691.  
  692.              Mark a line with alt-l or f3-mark_Line.
  693.  
  694.              Mark the first and last lines of a set with alt-l or f3-mark_Line.
  695.  
  696.              Mark a column with f3-mark_column.
  697.  
  698.              Mark the first and last columns of a group with f3-mark_Column.
  699.  
  700.              Mark the entire session with f3-mark_All.
  701.  
  702.              Mark  a block from  the cursor  to  column  1  or 255  with  alt-b
  703.              (f3-mark_Block) and then alt-l (f3-mark_Line). If the cursor is to
  704.              the left of the mark when you press alt-l then the mark is  filled
  705.              out to column 1, otherwise it is filled out to column 255.
  706.  
  707.              Mark a block from the cursor to the top or bottom line with  alt-b
  708.              (f3-mark_Block) and then f3-mark_Column.  If the cursor is to  the
  709.              above the mark when  you do f3-mark_Column then the mark is filled
  710.              out  to the top line,  otherwise  it  is filled  out to the bottom
  711.              line.
  712.  
  713.              Mark a block with the same columns as the previous mark but with a
  714.              new  set  of  lines  with  alt-l  (f3-mark_Line)  and  then  alt-b
  715.              (f3-mark_Block).  This  is  useful  for flowing  several different
  716.              paragraphs to the same margins.  If you have set word wrap margins
  717.              to  something  other than 1 and 255  then alt-l  alt-b  sets these
  718.              margins.
  719.  
  720.              Mark a full column mark with the same columns as the previous mark
  721.              with f3-mark_column and then alt-b  (f3-mark_Block).  If you  have
  722.              set word wrap  margins  to something other  than 1  and  255  then
  723.              f3-mark_column alt-b sets these margins.
  724.  
  725.              Mark the set of lines from the  cursor to the top or bottom of the
  726.              file with alt-l  (f3-mark_Line) and  then  f3-mark_column.  If the
  727.              cursor is  above the initial mark when you do  f3-mark_column then
  728.              the  mark  is  extended to  the top  of the file,  otherwise it is
  729.              extended to the bottom of the file.
  730.  
  731.              Mark  a full column  mark from the cursor  to column 1 or 255 with
  732.              f3-mark_column and then alt-l (f3-mark_Line).  If the cursor is to
  733.              the left of the initial mark when you press alt-l then the mark is
  734.              extended to column 1, otherwise it is extended to column 255.     
  735.  
  736.                                                                            p-16
  737.            A marked area is highlighted by either underscores or a blue or gray
  738.            background (depending on the display and display mode).
  739.  
  740.            Alt-u (or f3-Unmark) unmarks an area mark.
  741.  
  742.            If an area mark exists and you attempt to create a new one, you will
  743.            get the "Area mark  already  exists" message.  When  this message is
  744.            present, and you repeat the function, the first area is unmarked and
  745.            the requested function works as usual.
  746.  
  747.            F3-mark_block_resize, f3-mark_line_resize, f3-mark_column_resize are
  748.            similar  to the functions explained above, except that when there is
  749.            a complete area and you use the  resize functions, they  will modify
  750.            the  area  mark instead  of  giving the  "Area mark  already exists"
  751.            message.  F3-mark_block_resize updates one corner of the  area mark.
  752.            F3-mark_line_resize  extends or  shrinks the  area mark to cover the
  753.            current  line, leaving the margins unchanged.  F3-mark_column_resize
  754.            extends  or  shrinks the  area mark  to  cover  the  current column,
  755.            leaving the covered  lines  unchanged.  Shrinkage is done  initially
  756.            from the closest side or corner of the mark. Repeating the functions
  757.            cycles through the possibilities of new area marks.                 
  758.  
  759.                                                                            p-17
  760.          Operating On An Area Mark --------------------------------------------
  761.  
  762.            The following are the basic area mark functions.
  763.  
  764.              Alt-c (f9-Copy_lines)  copies all lines in the area mark after the
  765.              cursor  line.  Entire lines are copied, even if the area mark does
  766.              not cover columns 1 to 255.
  767.  
  768.              Alt-d deletes the contents of an area mark.  Full  line marks  are
  769.              deleted and the lines removed.  Blocks are deleted and the columns
  770.              to  the  right of the mark  are shifted left.  F9-delete_lines and
  771.              f9-delete_block  do  the same  function  but  require  a  specific
  772.              choice.
  773.  
  774.              Alt-g moves the cursor to the position mark and,  on a consecutive
  775.              press, to the area mark, and then on another press,  to the bottom
  776.              of the  area  mark.  F4-go_Ar_mk_ul  and  f4-go_ar_mk_ll  move the
  777.              cursor to the upper left and lower left corners of the mark.
  778.  
  779.              Alt-i (f9-Insert)  inserts the marked area at the cursor location,
  780.              shifting  current text to the right.  If data will  be pushed past
  781.              column  255  (and  therefore lost) then you are given an  are your
  782.              sure prompt.  In general if  the  cursor position is such that the
  783.              contents of the area mark would be changed by  this operation then
  784.              it is not allowed. An area can be inserted to the left of the mark
  785.              if the cursor is aligned with the top  of the mark.  In  this case
  786.              the mark is moved to cover the same text as before the operation.
  787.  
  788.              Alt-m (f9-Move  lines) moves all lines in  the area mark after the
  789.              cursor  line.  Entire lines are moved, even if the area mark  does
  790.              not cover columns 1 to 255.
  791.  
  792.              Alt-o  (f9-Overlay)   overlays  the  marked  area  at  the  cursor
  793.              location.  If  data will be overlayed past column 255 then you are
  794.              given an are your sure prompt. If the cursor position is such that
  795.              the contents of the area mark would  be changed  by this operation
  796.              then it is not allowed.
  797.  
  798.              F9-merge  overlays  the marked area at  the cursor  only where the
  799.              target area is blank.  If the cursor  position  is  such that  the
  800.              contents of the area mark would be changed by  this operation then
  801.              it is not allowed.
  802.  
  803.              Alt-v horizontally centers the contents of an area mark within the
  804.              area mark.  Another (consecutive) press of alt-v moves the text to
  805.              the left side of the area mark (line by line). A third consecutive
  806.              press of  alt-v moves the text to the right side of the area mark.
  807.              F8-Center,   f8-Left_side,  and  f8-Right_side  provide  the  same
  808.              function.
  809.  
  810.              Alt-4 (f9-blank) blanks the marked area.
  811.  
  812.              F8-Upper  and f8-Lower uppercase and lowercase the text within the
  813.              area mark.
  814.  
  815.              F8-upper_First  uppercases  the first letter  of each  word in the
  816.              mark.                                                             
  817.  
  818.                                                                            p-18
  819.              F8-shift_up shifts text within the area mark up one line.  If data
  820.              will be lost at the edge of the mark then you will be given an are
  821.              you sure prompt.  Repeated presses do not give this  prompt (after
  822.              the first affirmative answer).
  823.  
  824.              F8-shift_down shifts text within the area mark down one line.
  825.  
  826.              Alt-9  (f8-shift_left)  shifts  text within the area mark left one
  827.              column.
  828.  
  829.              Alt-0  (f8-shift_right) shifts text within the area mark right one
  830.              column.
  831.  
  832.            Each of  these functions has  an  equivalent  function that operates
  833.            only  on unexcluded lines.  They are available on the menus and  are
  834.            labeled with  "unex".  With  the  overlay and insert functions, only
  835.            excluded lines  from the marked area are ignored.  Excluded lines in
  836.            the target area are treated as usual.
  837.  
  838.            The  horizontal and vertical  shift functions,  the  upper and lower
  839.            case  functions, the fill  functions,  and the non-line area  delete
  840.            function may only be done when some part of the area  mark is in the
  841.            current window. If you try to delete a line area mark that is not in
  842.            the current window, you will be prompted for confirmation.
  843.  
  844.            Area  marks are  also  used in  conjunction  with the  Find, Change,
  845.            Print,  and  Order  commands,  and  the  flow,   exclude,  and  fill
  846.            functions.                                                          
  847.  
  848.                                                                            p-19
  849.          Fill Area Functions --------------------------------------------------
  850.  
  851.            Alt-3 (F9-fill_nm_line) fills  the  marked  area with a numeric line
  852.            pattern.  To  fill an area mark from the cursor to the bottom of the
  853.            mark with a line pattern, enter the pattern and press Alt-3.  If the
  854.            cursor  is on a number then  the  number will  be incremented in the
  855.            cursor column on each succeeding line.
  856.  
  857.            Alt-5 (F9-fill_block_pat) fills the marked area with  a  rectangular
  858.            pattern.  To use this function,  enter the fill pattern in the upper
  859.            left  corner  of  the mark,  position the  cursor on the lower right
  860.            corner of the pattern, and press Alt-5.
  861.  
  862.            The cursor may not be on an excluded line during a fill function.
  863.  
  864.            For example:
  865.  
  866.              block pattern          numeric line pattern
  867.  
  868.              z______  abc____       ____36.  _A00007  _____70  ____x70  abcd___
  869.              _______  def____       _______  _______  _______  _______  efghij_
  870.              _______  _______       _______  _______  _______  _______  lmnopqr
  871.              _______  _______       _______  _______  _______  _______  _______
  872.              _______  _______       _______  _______  _______  _______  _______
  873.  
  874.              cursor position:
  875.  
  876.              on z     on f          on 6     on 7     on 7     on 7     on l
  877.  
  878.              yields:
  879.  
  880.              zzzzzzz  abcabca       ____36.  _A00007  _____70  ____x70  abcd___
  881.              zzzzzzz  defdefd       ____37.  _A00008  _____80  ____x80  efghij_
  882.              zzzzzzz  abcabca       ____38.  _A00009  _____90  ____x90  lmnopqr
  883.              zzzzzzz  defdefd       ____39.  _A00010  ____100  ____x00  lmnopqr
  884.              zzzzzzz  abcabca       ____40.  _A00011  ____110  ____x10  lmnopqr
  885.  
  886.            The  next to last example  gives a  "Numeric  fill overflow" message
  887.            since RE will not overwrite  the "x".  Only blanks and  0..9 will be
  888.            overwritten.
  889.  
  890.            These  functions   will   ignore   excluded   lines   if   you   use
  891.            F9-fill_num_ln_pt_unex and F9-fill_block_pat_unex.
  892.  
  893.            The numeric line pattern fill is useful when using the line ordering
  894.            command  to preserve  the original order of lines.  Before doing any
  895.            sorting, number all lines. Then to get the original order back, sort
  896.            on these numbers.                                                   
  897.  
  898.                                                                            p-20
  899.          Line Exclude Functions -----------------------------------------------
  900.  
  901.            The line  exclude function is  used to hide lines from the  display.
  902.            These lines are not deleted from the file, only from the display.  A
  903.            hidden  line or set of lines is seen on the screen as a dashed  line
  904.            followed by the number of hidden lines. The leftmost nonblank column
  905.            of each hidden line is marked with a plus sign on top  of the dashed
  906.            line.
  907.  
  908.            Alt-x (or  f5-ex_mark_indent) is  the exclude  lines  by indentation
  909.            function.  It is used both to exclude and reshow lines, depending on
  910.            the  position of the  cursor  and the  margins of the area mark.  To
  911.            exclude or reshow  a group of  lines,  first mark  the lines with an
  912.            area mark.  Then position the cursor and press alt-x.  If the cursor
  913.            is inside  the  area  mark  then  all lines whose  leftmost nonblank
  914.            character within  the mark is  at or to  the right of the cursor are
  915.            excluded  (hidden).  All  other  lines are shown.  If  the cursor is
  916.            outside the mark then all lines in the mark are  shown.  Blank lines
  917.            are excluded as if they had a nonblank character in column 256.
  918.  
  919.            F5-ex_Indent excludes the  entire  file by  indentation  (as  if the
  920.            entire file were covered with an area mark).
  921.  
  922.            F5-ex_mark_para  is  the exclude  lines by  paragraph  function.  It
  923.            causes  all  lines that  are nonblank within the  area  mark and are
  924.            preceded  by lines that are blank  within  the area mark to be shown
  925.            and all others in the mark to be excluded. If you leave a blank line
  926.            between each paragraph or subroutine, then this functions compresses
  927.            the file  view by  showing only the first  line in each paragraph or
  928.            subroutine.
  929.  
  930.            F5-ex_Para excludes the entire file by paragraph.
  931.  
  932.            F5-show_Changes shows all modified and new lines (since the start of
  933.            the session). This function acts on the entire file.
  934.  
  935.            F5-Show_all unexcludes the entire file.
  936.  
  937.            F5-show_Mark  unexcludes  all  lines in  the  area mark.  F5-ex_mark
  938.            excludes all lines in the area mark.
  939.  
  940.            F5-Reverse_ex  and  f5-reverse_ex_mark  reverse  the  excluded  line
  941.            status of each line in the file or mark.
  942.  
  943.            Alt-r (or f5-reshow) reshows all lines in a set of excluded lines.
  944.  
  945.            F5-ex_One_line excludes the line that the cursor is on.
  946.  
  947.            F5-unex_First_line  and  f5-unex_Last_line unexclude  the  first and
  948.            last lines from an excluded group.
  949.  
  950.            F5-ex_children excludes  all lines below the current  line up to the
  951.            next line that  starts at or to the left of the start of the current
  952.            line.
  953.  
  954.            Alt-6 excludes children on  the first press and unexcludes them on a
  955.            consecutive press.                                                  
  956.  
  957.                                                                            p-21
  958.            F5-unex_one_level reexcludes an excluded group  by  indentation with
  959.            the cursor one character  to the right  of  the start  of the group.
  960.            This is a macro that uses the area mark.
  961.  
  962.            F5-show_*  and  f5-show_mark_*  set  up  find  commands  to  exclude
  963.            everything  except the string that you  enter.  You must press enter
  964.            after entering the string.
  965.  
  966.            F5-ex_unex_mark_indent works  like  alt-x  except  that  it  ignores
  967.            excluded lines.
  968.  
  969.            F5-save_ex and f5-restore_ex  saves and restores the  excluded state
  970.            of a session.
  971.  
  972.            The home and end keys look for the leftmost and rightmost characters
  973.            in a set of excluded lines.  All of the area mark functions  work on
  974.            excluded lines just like they work on normal lines, except that when
  975.            you  mark an excluded line, all  of the lines in the set represented
  976.            by the  dashed line are included in the area mark.  The alphanumeric
  977.            keys, del, backspace, split/join, erase end of line, and enter ASCII
  978.            code, do not work on excluded lines.
  979.  
  980.            Several  RE  commands have options that let  you work  with excluded
  981.            lines or ignore the lines.  See  the X options of the  Find, Change,
  982.            Order, and Print  commands.  In  addition,  most  of  the area  mark
  983.            functions,  except  the  text flow functions,  have versions labeled
  984.            "unex" that ignore excluded lines.
  985.  
  986.            The  Find  command is important to making best use of excluded lines
  987.            because  when  a  string  is  found,  the  line  that  it  is on  is
  988.            unexcluded.  The  All, Show all, and Hide all options are  useful in
  989.            getting the proper lines excluded.
  990.  
  991.            The line exclude functions are very useful.  Below is a list of some
  992.            techniques that you may find helpful.
  993.  
  994.              The line  exclude function lets you compress the view of a file by
  995.              hiding lines that are low in the hierarchy of function. You should
  996.              design your coding  indentation method to  take  advantage of this
  997.              function.  To  compress the view of your entire file, by excluding
  998.              all lines that do not start in column 1, move the cursor to column
  999.              2 in the text area and do f5-ex_Indent. For example:
  1000.  
  1001.                (* proc1 .. *)               --->         (* proc1 .. *)
  1002.                   procedure proc1;                          +-+----------..-- 7
  1003.                   var i: integer;                        (* proc2 .. *)
  1004.                   begin                                     +-+----------..-- 6
  1005.                     i:=1;
  1006.                     .
  1007.                   end;
  1008.                (* proc2 .. *)
  1009.                   procedure proc2;
  1010.                   var i: integer;
  1011.                   begin
  1012.                     .
  1013.                   end;                                                         
  1014.  
  1015.                                                                            p-22
  1016.              BASIC  programs may be similarly shown.  For example, to show  the
  1017.              subroutine structure of the program on the left:  move  the cursor
  1018.              to column 5  in  the text  area  and do  f3-mark_Column  and  then
  1019.              f3-mark_Line (or alt-l); position  the  cursor in the area mark on
  1020.              column 7; and press alt-x (or f5-ex_mark_indent).
  1021.  
  1022.                1000 'MAIN ROUTINE         --->    1000 'MAIN ROUTINE
  1023.                1010   GOSUB 2000                  +----------------------..-- 4
  1024.                1020   GOSUB 3000                  2000 'GET DATA
  1025.                1030   GOSUB 4000                  +----------------------..-- 2
  1026.                1040   STOP                        3000 'CALCULATE RESULTS
  1027.                2000 'GET DATA                     +----------------------..-- 2
  1028.                2010   .                           4000 'OUTPUT RESULTS
  1029.                2020   .                           +----------------------..-- 2
  1030.                3000 'CALCULATE RESULTS
  1031.                3010   .
  1032.                3020   .
  1033.                4000 'OUTPUT RESULTS
  1034.                4010   .
  1035.                4020   .
  1036.  
  1037.              To  add  confidence  to moves of large blocks of text, exclude the
  1038.              middle lines of the  block.  This  lets you view the  entire block
  1039.              while doing the move.
  1040.  
  1041.              Another  use  of  the  line exclude  function  is  to  help column
  1042.              manipulation.  If you want to  move columns of text,  exclude  all
  1043.              lines of the column except the first and last.  Then it is easy to
  1044.              put an area mark around an entire column.
  1045.  
  1046.              Suppose you want to find the  rightmost character in  a  group  of
  1047.              lines.  Mark the group with a  line area  mark and  do f5-ex_mark.
  1048.              This  excludes all lines in the group.  Then press end to move the
  1049.              cursor to  the blank after  the rightmost character.  Press alt-u,
  1050.              alt-b, cursor left, alt-b, cursor right, and alt-x. All lines with
  1051.              characters in the rightmost position will be unexcluded (this will
  1052.              not work if the rightmost character is in column 255).
  1053.  
  1054.              The  line exclude function is  also useful for matching  BEGIN and
  1055.              END statements in the case  of missing or extra END statements (in
  1056.              Pascal). Exclude statements between the lowest level BEGIN and END
  1057.              statements. Continue excluding statements between higher levels of
  1058.              BEGIN and END statements until you find your problem. You can also
  1059.              try the commands "fs begin" and then "fa end".
  1060.  
  1061.              If you want to re-exclude  an excluded group of lines,  but do not
  1062.              know what  level of indentation to use: put the cursor on the line
  1063.              and press alt-l; press  alt-r to reshow  the  lines but  leave the
  1064.              area mark; choose a cursor position; and press alt-x.             
  1065.  
  1066.                                                                            p-23
  1067.              If you want  to sort a section of an outline, retaining sub-topics
  1068.              with  their  title  line,  exclude   the  sub-topics  (exclude  by
  1069.              indentation)  and  sort  with the  X option or f10-ascend_ex.  For
  1070.              example:
  1071.  
  1072.                title C    -->  title C        -->  title A       -->  title A
  1073.                  line c1         +------- 3          +------- 1         line a1
  1074.                  line c2       title A             title B            title B
  1075.                  line c3         +------- 1          +------- 2         line b1
  1076.                title A         title B             title C              line b2
  1077.                  line a1         +------- 2          +------- 3       title C
  1078.                title B                                                  line c1
  1079.                  line b1                                                line c2
  1080.                  line b2                                                line c3
  1081.  
  1082.                                                                            p-24
  1083.          Position Mark Functions ----------------------------------------------
  1084.  
  1085.            The alt-p key places the position mark under the cursor.  After  the
  1086.            cursor is moved,  the position mark  is  seen as a bright background
  1087.            (red on a color screen). The position mark may be placed in the text
  1088.            area only.
  1089.  
  1090.            The  position mark may be reset  at  any time by pressing alt-p.  To
  1091.            delete the  position mark, put  the  cursor  on top of the mark  and
  1092.            press alt-p.
  1093.  
  1094.            When the position  mark  is  in  the  current  edit session, and the
  1095.            cursor is on an editable or excluded line, then the width and height
  1096.            from  the position mark to the  cursor (inclusive)  are displayed on
  1097.            the status line in place of the file name.
  1098.  
  1099.            The alt-p and alt-g keys work  together to  provide a mark  position
  1100.            and go to marked position function. Alt-p sets the position mark. To
  1101.            return  to this  position from anywhere  within  RE except  the help
  1102.            system,  press alt-g (or f4-go_Pos_mk).  (A second press of alt-g or
  1103.            if  there is no position mark moves the cursor to the  area mark and
  1104.            then the bottom of the area mark.)
  1105.  
  1106.            If the cursor is  not on the position  mark then you  may delete the
  1107.            mark by  pressing  alt-p twice.  The first alt-p moves the  position
  1108.            mark under the cursor, and the second deletes it.
  1109.  
  1110.            F3-set_Pos_mk, f3-remove_ps_mk, and f4-go_Pos_mk provide menu access
  1111.            to these functions.                                                 
  1112.  
  1113.                                                                            p-25
  1114.          Word Wrap Margins Command --------------------------------------------
  1115.  
  1116.            "W ((col1) col2)" sets the word wrap margins. If the columns are not
  1117.            present  then 1 and 255 are assumed.  If just one column  is present
  1118.            then the left margin is set to 1.
  1119.  
  1120.            Word   wrap   margins  may  be  set  at  the  cursor  position  with
  1121.            f6-set_Left_margin and f6-set_Right_margin. And they may be set to 1
  1122.            and  70  with   f6-margin_1..70  or  reset   to   1  and   255  with
  1123.            f6-margins_Off. F6-Margins_*_* sets up a general W command.
  1124.  
  1125.            See ENTERING TEXT for a description of RE's word wrap function.
  1126.  
  1127.            When the word wrap margins are not 1 and 255, and you create an area
  1128.            mark  with  alt-l  alt-b, then  the mark  will span  the  word  wrap
  1129.            margins.
  1130.  
  1131.          Tab Command ----------------------------------------------------------
  1132.  
  1133.            The T command lets you specify what kind of tabs you want to use. "T
  1134.            (setnumber)"  sets the tab keys to use the specified tab set number.
  1135.            1 is the default which is an automatic  tab function.  Tab set 2 has
  1136.            tabs at 1, 9, 17, ... Tab sets 3 through 10 are not defined. See the
  1137.            REPROF.DOC to set these up as desired.
  1138.  
  1139.            "T col1 col2 .." sets conventional tabs at col1, col2, etc. You must
  1140.            use at least two columns so that  RE  recognizes that  you  are  not
  1141.            trying to set a tab set.
  1142.  
  1143.            "T A l c" sets  the  automatic  tab  looking  at l lines (1..8)  and
  1144.            maximum columns c (1..254). The default tab set 1 is A 4 8.
  1145.  
  1146.            In  automatic  tab mode, tab positions are determined by RE and  are
  1147.            based on word starts on the current line and a number of lines above
  1148.            the current line. The tab positions are:
  1149.  
  1150.              columns 1 and 255
  1151.  
  1152.              the start of every word on the current line
  1153.  
  1154.              the start of every word on the line above this if that position is
  1155.              not between  one  blank  to the left of a word on the current line
  1156.              and one blank to the right of a word on the current line and so on
  1157.              for each examined line above this
  1158.  
  1159.              a set number of columns in both directions from the cursor        
  1160.  
  1161.                                                                            p-26
  1162.          Basic Flow Functions -------------------------------------------------
  1163.  
  1164.            The flow and right justify functions flow (or reflow ) the  words in
  1165.            a  set of lines,  so that  they  fill but do  not exceed  the  space
  1166.            between two columns.  Additionally, the first word may be positioned
  1167.            anywhere  from  column  one  to  the right column.  This allows  for
  1168.            indentation  of the first line of a paragraph, or outline numbers to
  1169.            the left of a flowed group.
  1170.  
  1171.            The flow into list function flows the words in a set of lines into a
  1172.            list so that each word is on a separate line.
  1173.  
  1174.            The alt-f key (or f6-flow_mark) is the flow function key.  To flow a
  1175.            group of lines, set an area mark  such that the  lines  to be flowed
  1176.            are contained between  the upper  and lower limits of area mark, and
  1177.            the left and right  margins are set with the left and right sides of
  1178.            area mark.  If you want a special position for the first word in the
  1179.            flow, move the cursor to  this  position  (on the first line  of the
  1180.            area mark). Then press alt-f.
  1181.  
  1182.            Alt-j and f6-rt_justify_mk  work exactly like  alt-f except that the
  1183.            text is right justified. Spaces are added evenly between words; then
  1184.            extra spaces are added at  random after periods, exclamation points,
  1185.            and  question  marks; and  then extra spaces  are  added randomly at
  1186.            other spaces.  Spaces are never added to spaces that are to the left
  1187.            of the area mark.
  1188.  
  1189.            Alt-t (or f6-flow_mark_list) is the flow into list function. To flow
  1190.            the words in  a group  of lines into a list,  set an  area mark such
  1191.            that the left  side of the mark is where you want the left margin of
  1192.            the list.  Words that are wider than the mark will be split, so make
  1193.            the mark wide enough  to handle all of the words (use alt-b alt-l to
  1194.            insure this). Then press alt-t.
  1195.  
  1196.            The flow functions will work only if the area mark is in the current
  1197.            window.  If your area mark is only one column wide, then you will be
  1198.            prompted for confirmation.
  1199.  
  1200.            If you  are  flowing a number of paragraphs (with the same margins),
  1201.            use  the alt-b alt-b key combination to  set the first area mark and
  1202.            then the  alt-l alt-b key combination to set successive  area marks.
  1203.            The alt-l alt-b key combination preserves your margins, reducing the
  1204.            keystrokes needed to set up the required area mark.
  1205.  
  1206.            Or if you set the  word wrap margins to other  than 1 and 255, alt-l
  1207.            alt-b sets up the area mark to match those margins.
  1208.  
  1209.            Flow and right justify functions that add an extra space at the  end
  1210.            of a sentence are  available,  but  are not  assigned in the default
  1211.            profile. See REPROF.DOC.                                            
  1212.  
  1213.                                                                            p-27
  1214.            Here are three examples of the flow functions.
  1215.  
  1216.              If  you  have  a paragraph  in  broken  format or  with the  wrong
  1217.              margins, such as:
  1218.  
  1219.                Ravitz Editor (RE) is a general purpose full screen ASCII
  1220.                  text   editor for the      IBM Personal Computer family.
  1221.                It requires an 80     column        (or greater), 256 Kbytes of
  1222.                memory,  and  DOS version   2.0 or higher.
  1223.  
  1224.              and you want it right justified between columns 7 and 70: move the
  1225.              cursor  to  the first line on column  7 and press  alt-b; move the
  1226.              cursor to the last line on column 70 and press alt-b; press alt-j.
  1227.              The result is:
  1228.  
  1229.                Ravitz Editor (RE) is a  general  purpose full screen ASCII text
  1230.                editor for the IBM Personal  Computer family.  It requires an 80
  1231.                column (or greater), 256 Kbytes of memory,  and  DOS version 2.0
  1232.                or higher.
  1233.  
  1234.              If  you  prefer  to indent the paragraph  five  spaces, follow the
  1235.              previous instructions, except  before you press  alt-j,  move  the
  1236.              cursor back to the first line on column 12. The result is:
  1237.  
  1238.                     Ravitz Editor (RE) is a general purpose full  screen  ASCII
  1239.                text editor for the IBM Personal Computer family. It requires an
  1240.                80 column (or greater), 256  Kbytes  of memory,  and DOS version
  1241.                2.0 or higher.
  1242.  
  1243.              If you are doing a list, try the following. For this text:
  1244.  
  1245.                2)   Ravitz Editor (RE) is a
  1246.                general purpose full screen  ASCII
  1247.                text editor for the IBM Personal Computer family. It requires an
  1248.                80 column (or greater), 256
  1249.                    Kbytes of memory, and DOS version
  1250.                2.0 or higher.
  1251.  
  1252.              Move  the  cursor to  the first line on column 10 and press alt-b;
  1253.              move  the cursor to the last  line on column  70 and  press alt-b;
  1254.              move the cursor  to the first line on  column 7; press alt-f.  The
  1255.              result is:
  1256.  
  1257.                2) Ravitz Editor (RE) is a general purpose full screen ASCII
  1258.                   text editor for the IBM Personal Computer family. It requires
  1259.                   an 80 column (or greater), 256 Kbytes of memory, and DOS
  1260.                   version 2.0 or higher.                                       
  1261.  
  1262.                                                                            p-28
  1263.          Paragraph Reflow Functions -------------------------------------------
  1264.  
  1265.            F6-Flow_para and  f6-rt_Justify_para are  macros that do  everything
  1266.            necessary to flow  a  paragraph.  They  assume  that  paragraphs are
  1267.            delimited by blank lines, and mark the paragraph  that the cursor is
  1268.            in or  above based on either the word wrap margins or if the margins
  1269.            are 1 and  255 then based on the last area mark.  The indentation of
  1270.            the first line is at  the  cursor position.  After the  paragraph is
  1271.            reflowed,  the cursor is  moved below  it.  The current area mark is
  1272.            removed by these functions.
  1273.  
  1274.          Drawing Modes --------------------------------------------------------
  1275.  
  1276.            Alt-z  rotates  between  the  three  drawing modes and normal  mode.
  1277.            Starting from normal editing  mode,  one  press of alt-z sets single
  1278.            line  drawing  mode.  Another  consecutive  press  sets  double line
  1279.            drawing  mode.  Another  consecutive  press sets  current  character
  1280.            drawing  mode.  And one  more  consecutive  press  returns to normal
  1281.            editing.  The drawing modes can only be set in the text area. In the
  1282.            line modes, the  PC  ASCII  line character set  is used.  In current
  1283.            character mode, the character that the cursor is on when the mode is
  1284.            invoked is the drawing character.
  1285.  
  1286.            Drawing modes may also be set from the f3 menu.
  1287.  
  1288.            In  the drawing modes, use the cursor keys to trace out  lines.  The
  1289.            drawing character is placed  at the current cursor position and then
  1290.            the cursor is moved in the direction  specified.  In the line modes,
  1291.            joints with other line  characters are done automatically  (but only
  1292.            after the cursor is moved from a position, not when it is moved to a
  1293.            position).  Any key  other  than  the cursor keys and  the set/reset
  1294.            position mark key returns you to normal editing mode.
  1295.  
  1296.            While there  are  only two  line modes, boxes with mixed  modes (for
  1297.            example  double  horizontal and single vertical, or double upper and
  1298.            left  and single lower  and right) may be  created by switching line
  1299.            drawing modes at the corners.
  1300.  
  1301.            One  note  on using mixed line modes may be useful.  If you  have  a
  1302.            double line  and you want to T into it with a single line, bring the
  1303.            cursor up  to the line and then  move it back in the direction  from
  1304.            which it came to complete the joint.
  1305.  
  1306.                             ║                     ║                     ║
  1307.                             ║                     ║                     ║
  1308.              cursor line                          ║      cursor line    ║
  1309.                          ───────   cursor line ───────               ───╨───   
  1310.  
  1311.                                                                            p-29
  1312.          Find Command ---------------------------------------------------------
  1313.  
  1314.            With  the  find  command you can have RE search for a word or  other
  1315.            string. The form of the find function is "F string options". If your
  1316.            string contains blanks  then enclose the string  in  apostrophes  or
  1317.            quotes (' or ").  When  you press  enter  the search  starts at  the
  1318.            cursor position and continues  to the last line (first  line if  you
  1319.            use  options P  or L).  If  the  string is found  then the cursor is
  1320.            placed at the start of the string.  If the  string is on an excluded
  1321.            line then that line is unexcluded.
  1322.  
  1323.            There are  several options to  let  you modify the search.  Each  of
  1324.            these options is represented by one letter.  Combinations of options
  1325.            may  be  entered  after the find string or may  be attached  to  the
  1326.            command letter.
  1327.  
  1328.              N lets you look  for  the  next  occurrence.  This  means that the
  1329.              search starts one space after the cursor position.
  1330.  
  1331.              P lets you look for the previous occurrence.  This means  that the
  1332.              search starts one space  before the cursor position and the search
  1333.              is in the backward direction.
  1334.  
  1335.              F starts the search on the first line and column of the file.
  1336.  
  1337.              L  starts the search on the  last  line and column of the file and
  1338.              causes a search in the backward direction.
  1339.  
  1340.              A finds  (and unexcludes) all occurrences, and  puts the cursor on
  1341.              the first  occurrence.  The number of  finds  is displayed on  the
  1342.              "Found"  message.  If First, Last, Next, or Previous is specified,
  1343.              then that  specifies  the starting point  of the search  otherwise
  1344.              First is assumed.
  1345.  
  1346.              S  (show  all) excludes all lines of  interest (the whole  file or
  1347.              area mark, with  or without  excluded or unexcluded lines) that do
  1348.              not include the specified  find string and unexcludes  lines  that
  1349.              include the  string.  The  number of  finds is displayed  with the
  1350.              "Found"  message and the  cursor  is  put on the command line.  If
  1351.              First,  Last, Next, or  Previous is specified, then that specifies
  1352.              the starting point of the search otherwise First is assumed.
  1353.  
  1354.              H (hide all) is like S  (show  all)  except  that it excludes  all
  1355.              lines of  interest that  include  the  specified  find  string and
  1356.              unexcludes lines that do not include the string.
  1357.  
  1358.              C  causes  RE to check  for a  match of the capitalization of each
  1359.              letter  in  the  find  and  file  strings.  Without  this  option,
  1360.              capitalization  (of the  find string and file  strings) is ignored
  1361.              (by internally converting the strings to uppercase).  For example,
  1362.              to  find the string "RE" without  finding the string "re", use the
  1363.              command "f RE c".                                                 
  1364.  
  1365.                                                                            p-30
  1366.              M restricts the  search to the current  area mark.  For example to
  1367.              find the string "the"  only  in  the  first  20  columns,  use the
  1368.              command "m 1 20" to mark the columns, and then  use the command "f
  1369.              the m" to do the search. Even with the M option, the search starts
  1370.              at  the cursor and goes in the normal direction, so if  the cursor
  1371.              is below an area mark and the search is in  the forward direction,
  1372.              nothing will be found.
  1373.  
  1374.              W  narrows the search by requiring  that your string be surrounded
  1375.              by blanks or punctuation.  This implies (loosely) that your string
  1376.              is a word.  For example, if you use the command "f and w" then the
  1377.              next occurrence of the word "and" will be found while the "and" in
  1378.              "landing" will be ignored.  Characters that  do  not delimit words
  1379.              are:  #, $, %, 0..9, @, A..Z, a..z.  All other characters are word
  1380.              delimiters. To change this choice see the @FINDWORD in REPROF.DOC.
  1381.              Any character may be contained within the word.
  1382.  
  1383.              B says to accept a  string only if it is  the beginning of a word.
  1384.              See the W option, above, for details on what is considered a word.
  1385.  
  1386.              E says to accept a string only if it is the end of a word. See the
  1387.              W option, above, for details on what is considered a word.
  1388.  
  1389.              U says to ignore unexcluded lines.
  1390.  
  1391.              X says to ignore excluded lines.
  1392.  
  1393.            The First, Last,  Next, Previous options are mutually exclusive, and
  1394.            may not be combined in one find command. Show all, Hide all, and All
  1395.            are also mutually exclusive.
  1396.  
  1397.            The F7 menu gives a number of standard Find commands to choose from.
  1398.  
  1399.            After a Find command  is executed,  the find  string  and  a set  of
  1400.            options are displayed on the status line. These options are the ones
  1401.            that you entered in your find command,  except that S, H, and A  are
  1402.            not shown, F is changed to  N, L is changed to P, and if you did not
  1403.            specify either N or P then  N is added.  The  displayed  string  and
  1404.            options are used if you do a repeat  find function.  Press alt-1 (or
  1405.            F7-repeat_Find) to do the repeat find. The displayed string may also
  1406.            be  referenced by using a * or blank for the string in an F command.
  1407.            The displayed options may be referenced by using *.  The repeat find
  1408.            function is equivalent to the command "F * *" or "F*".
  1409.  
  1410.            Before  alt-1 repeats the displayed find, it checks the command line
  1411.            for a Find or Change command. If it finds a Find command it executes
  1412.            that command instead of repeating the displayed find.  If it finds a
  1413.            Change command  then it executes the find associated with the change
  1414.            and updates the  displayed  change string (see the  next section for
  1415.            more information on the Change command).
  1416.  
  1417.            The  Hide all option unexcludes  lines before excluding found lines.
  1418.            If  you  want to use it  to successively exclude  lines, use  the  X
  1419.            option  also.  Similarly, to use the S option to successively reshow
  1420.            lines, use the U option also.
  1421.  
  1422.            Break cancels a find command.                                       
  1423.  
  1424.                                                                            p-31
  1425.          Change Command -------------------------------------------------------
  1426.  
  1427.            The Change command  does the same search  as the find function,  and
  1428.            then  replaces  the string with  another  string.  Its  form  is  "C
  1429.            findstring changestring  options".  The  change string  is displayed
  1430.            beside the find string on the status line. The syntax and options of
  1431.            the Change command are the same as for the Find command, except that
  1432.            the Next and Previous options start the search at the current cursor
  1433.            position, not the next or previous space.
  1434.  
  1435.            The  F7  menu gives a number of  standard Change  commands to choose
  1436.            from.
  1437.  
  1438.            The findstring of the  Change  command  and the string  of the  Find
  1439.            command  are the same quantity.  So, for example, if  you have found
  1440.            the string  "hte"  with the command "F hte",  you  may change it  to
  1441.            "the" with the command "C * the".
  1442.  
  1443.            If  you press alt-r (f1-Reshow) immediately after changing a string,
  1444.            the  string will be un-changed.  This will not work if you  used the
  1445.            All, Show all, or Hide all option.
  1446.  
  1447.            If your  change will  not  fit  in  255  columns, you will  get  the
  1448.            "Line(s) too long" message and the change will not be done.
  1449.  
  1450.            Break cancels a change command.
  1451.  
  1452.            You may repeat a Change command with alt-2 or F7-repeat_Change. This
  1453.            is equivalent to the command "C * * *" or "C*". Before alt-2 repeats
  1454.            the  displayed change, it checks  the  command line  for a  Find  or
  1455.            Change command.  If  it finds a  Find command it updates the current
  1456.            find string and options before doing the repeat change function.  If
  1457.            it finds a Change command then that  command is  executed instead of
  1458.            repeating the displayed change.
  1459.  
  1460.            A special  case  of the Change command with the  all  options occurs
  1461.            when the find and change  strings both have  no nonblank characters,
  1462.            such as CA ' '  ''.  In this case, nothing to the right of the  last
  1463.            nonblank character on a  line can change,  so these  changes are not
  1464.            reported in the change count.
  1465.  
  1466.            There is no "replace with query" command in RE. However, you can get
  1467.            the  same effect by using the alt-1  (repeat find) and alt-2 (repeat
  1468.            change) functions.  Use  alt-1  to find each string and use alt-2 to
  1469.            change the ones that you want to change.                            
  1470.  
  1471.                                                                            p-32
  1472.          Order Lines Command --------------------------------------------------
  1473.  
  1474.            To reorder a group of lines, mark the lines with an area mark.  Mark
  1475.            the columns on which to sort with the margins of the area mark. Then
  1476.            execute the O command. Two option selections are required. The first
  1477.            is one  of  the three  options A (ascending),  D (descending), and R
  1478.            (reverse).  The  second is one of the two options X (retain excluded
  1479.            lines with  their  parent  line)  and I (sort  lines independently).
  1480.            Normally the  sort  is  alphabetical,  ignoring  capitalization  and
  1481.            punctuation on characters (for  example "A"  is the  same as "a" and
  1482.            "á"). The C option causes the sort to be by ASCII code.
  1483.  
  1484.            RE's sorts are stable, that is,  lines  with equal sort value remain
  1485.            in  the same order.  This property lets you sort on multiple fields.
  1486.            To do this sort the least significant field first, then  sort on the
  1487.            next least significant field, and so on to the most significant.
  1488.  
  1489.            With  the  A or  D  options,  sorts may  take  a  significant  time,
  1490.            depending  on the number  of lines sorted,  the number of columns in
  1491.            the mark, and the number of significant columns  in the mark.  Break
  1492.            cancels a sort at the next available break point.
  1493.  
  1494.            The f10 menu provides all Order possibilities.
  1495.  
  1496.            To sort sections of outlines, exclude the outline so that everything
  1497.            but  the section  titles are excluded.  Then use the X option of the
  1498.            Order command.
  1499.  
  1500.            To  modify  the   default  collating  sequence,   see  @SORTSEQ   in
  1501.            REPROF.DOC.
  1502.  
  1503.          Line Number Command --------------------------------------------------
  1504.  
  1505.            Any positive integer less than 60000 entered as a command will cause
  1506.            RE to move the  cursor  to that line number.  "0" will scroll to the
  1507.            top of the file.                                                    
  1508.  
  1509.                                                                            p-33
  1510.          Trash Buffer ---------------------------------------------------------
  1511.  
  1512.            When you modify a line in RE, the old line is  kept, temporarily, in
  1513.            the trash buffer.  To  access the trash buffer, use f2-Trash_buffer.
  1514.            This  will  display the  trash  buffer as if  it  were a  normal  RE
  1515.            session.  Text may be copied from the buffer by marking it and using
  1516.            any of  the copy  functions.  To exit  the trash buffer session, use
  1517.            alt-q, f2-Next_session, f2-Previous_session, or the Quit command.
  1518.  
  1519.            The trash buffer is a first in first out list with data added at the
  1520.            bottom and deleted at the top. In normal editing twenty lines are on
  1521.            the list.
  1522.  
  1523.            All area mark functions and Change All temporarily suspend  the list
  1524.            size limit, so if you delete  (for  example) 100 lines  with  alt-d,
  1525.            then the list will have 120 entries at that point.  If you need this
  1526.            data, get it back before any other editing because immediately prior
  1527.            to adding  the next  line to the list, it is  reduced back to twenty
  1528.            lines.  If  RE runs  short  of memory in such a  function,  it  will
  1529.            display the "Defragmenting memory" message  and reinstate the twenty
  1530.            line  limit.  DOS shells and the f3-free_memory function also shrink
  1531.            the trash list to twenty lines.
  1532.  
  1533.            If you put the position mark or an area  mark  in  the trash buffer,
  1534.            lines at or below the mark will not be deleted.  You can quickly run
  1535.            out of space this way, because data is never deleted.
  1536.  
  1537.            While  the  trash  buffer  is the active session in RE, it  does not
  1538.            accept or release trash.
  1539.  
  1540.            The  trash buffer is never the only session in RE.  If you have just
  1541.            one other session, and you quit out of that session, then RE returns
  1542.            you to  DOS, even if  the trash buffer is currently displayed in the
  1543.            inactive window.
  1544.  
  1545.            The trash  buffer may be  disabled -  see @trashlines in REPROF.DOC.
  1546.            This will improve speed on large area mark functions.
  1547.  
  1548.          Dos Shell Command ----------------------------------------------------
  1549.  
  1550.            "D  (command)" invokes a DOS shell.  If a command  is specified then
  1551.            only  that command is done and  control  is returned to RE.  If  the
  1552.            command leaves the  cursor  in the upper left corner  of  the screen
  1553.            then control  is given to  RE immediately.  This can be accomplished
  1554.            from a BAT file by making the last command CLS followed by ASCII 26.
  1555.            Otherwise  press enter to return to RE.  If  no command is specified
  1556.            then you must use the  EXIT command from DOS to get back to RE.  You
  1557.            must have at least 64K (4096 paragraphs) of free memory to use the D
  1558.            command.
  1559.  
  1560.            F2-dos and f2-dos_* set up DOS shell commands.
  1561.  
  1562.            The  commands DI, DM, and  DS invoke  program interface  DOS shells.
  1563.            These are currently used only by REPROF which can be called from the
  1564.            RE command line (DI REPROF) to assemble  the current RE session into
  1565.            a new RE.EXE.  See REPROF.DOC. Details of the interface will be made
  1566.            available later (if you have an immediate need, contact me).        
  1567.  
  1568.                                                                            p-34
  1569.          Windows and Split Screen ---------------------------------------------
  1570.  
  1571.            RE has two windows, A and B.  When RE is started window A is active.
  1572.            Alt-w or f1-Window_a/b switches the active window.  Window B behaves
  1573.            just like window A but  A and B  keep  distinct  positions  for each
  1574.            file.
  1575.  
  1576.            The   screen  may  show  either  window   alone  or  both   windows.
  1577.            F3-split_screen  splits  the  screen  at the cursor  and leaves both
  1578.            windows visible.  In this case, neither window  can  have less  than
  1579.            three lines of text.  When in split screen  mode the inactive window
  1580.            reflects the current  internal database  - the current  line  is not
  1581.            updated  until   that  line  is  saved  to  the  internal  database.
  1582.            F3-unsplit_screen makes the active window cover the entire screen.
  1583.  
  1584.            The keyboard cursor up and down keys automatically switch the active
  1585.            screen as they traverse the screen.  The autoscroll cursor functions
  1586.            (used by  the  mouse  and  installable on the  keyboard)  scroll the
  1587.            window rather than switching windows.
  1588.  
  1589.          Status Line ----------------------------------------------------------
  1590.  
  1591.            The second line on the RE screen is a status line. It is highlighted
  1592.            with a bright background. The cursor cannot be moved onto this line.
  1593.            If the screen is split  then  the status lines is  above the  active
  1594.            window and  another status  line with just a file name is  above the
  1595.            inactive window. The status line includes:
  1596.  
  1597.            25 columns for messages,  file  names, and the ruler
  1598.              If there  is no  other message then the active window letter (A or
  1599.              B) is displayed with either the file name or  the ruler, depending
  1600.              on the cursor position and the position mark status.
  1601.            "c" if the  keyboard is in caps  lock mode  or the current  user
  1602.              defined shift state
  1603.            "i", "s", "w", "┼", "╬","*", or "x" if RE is  in insert, autoscroll,
  1604.              word wrap,  single line draw,  double line draw, current character
  1605.              draw, or ignore excluded lines mode
  1606.            "u" if the session has not been changed
  1607.              The  change  state of a  session is  not updated  until the cursor
  1608.              leaves a line, so typing in an unchanged session does not cause it
  1609.              to be changed immediately.
  1610.            "á" or "a" if there is an incomplete or complete area mark
  1611.            "p" if there is a position mark
  1612.            the cursor column
  1613.            the line number  of the cursor  if the cursor  is  on an editable or
  1614.              excluded line, or the  line number of  screen line 3 if the cursor
  1615.              is on the command line and line 3 is an editable or excluded line
  1616.            the ASCII code (decimal) of the character at the cursor  position if
  1617.              the cursor is on an editable line or the command line
  1618.            the current find string
  1619.            the current change string
  1620.            the current find/change options
  1621.  
  1622.            If  the file  name, find string,  or  change string are too long for
  1623.            their status line  fields,  then  the  first  and last  parts of the
  1624.            strings  are  displayed,  with  a diamond  in the  middle.  Only the
  1625.            display is changed. The full strings are kept within RE.            
  1626.  
  1627.                                                                            p-35
  1628.          File and Device Names ------------------------------------------------
  1629.  
  1630.            RE  enforces file and device  name restrictions  for the Edit, Save,
  1631.            Print, and Name commands.  This  insures  that you do  not create or
  1632.            input files named by DOS truncating an invalid file name.
  1633.  
  1634.            RE  restricts  all  file and  device  names  to  DOS  2.0  file name
  1635.            standards.  All such  names  are valid under subsequent versions  of
  1636.            DOS. Later versions of DOS allow more flexibility in file names, but
  1637.            this  can  cause  problems  such   as  backward   compatibility  and
  1638.            uppercasing a file name producing an unexpected file.  ".\" (current
  1639.            directory)  and "..\" (parent directory) may be used at the start of
  1640.            a  file  name  (..\re.doc)  or  immediately after  a disk  specifier
  1641.            (c:..\re.doc),  but may  not be  used anywhere else.  All  paths are
  1642.            limited to 63 characters.  If you have  @exfilename set to ^yes then
  1643.            RE fully qualifies all file names that you input  and  all  expanded
  1644.            paths are limited to 63 characters.
  1645.  
  1646.            The standard DOS devices  (CON,  NUL, AUX, COM1, COM2,  COM3,  COM4,
  1647.            PRN, LPT1,  LPT2, and  LPT3) are further restricted to have no disk,
  1648.            path, or extension.  RE will not  let you Edit, Save, or Name any of
  1649.            these devices.
  1650.  
  1651.            And you cannot Save with extensions RE!, BAK, COM, or EXE.
  1652.  
  1653.          Memory Management ----------------------------------------------------
  1654.  
  1655.            Each  line  in   the  internal   database  requires  (i+24)  div  16
  1656.            consecutive  paragraphs  (16 characters) where i  is the  number  of
  1657.            characters included  within the  first and last nonblank characters.
  1658.            Lines that are seven or less characters take one paragraph.
  1659.  
  1660.            When RE finds that the available memory is less than about 2 Kbytes,
  1661.            it gives a free memory low warning.  Various functions are disabled.
  1662.            When a new line cannot  be stored in RE's internal data structure, a
  1663.            memory full error is displayed.
  1664.  
  1665.            Whenever RE is waiting for a keystroke it works at defragmenting the
  1666.            internal database.  Occasionally  you may  have  a  free memory  low
  1667.            warning  that  disappears spontaneously.  You may force  a  complete
  1668.            defragmentation with f3-free_memory (but this is never necessary).
  1669.  
  1670.            When  RE runs out of memory in the middle of  an  area  function  or
  1671.            while reading a file, it displays the message "Defragmenting memory"
  1672.            and completely defragments the internal database.  It may do this up
  1673.            to four times in trying to complete a function.
  1674.  
  1675.            F3-free_memory defragments RE's internal database  and  displays the
  1676.            amount of free memory.
  1677.  
  1678.            Whenever RE does a  complete memory  defragmentation  procedure,  it
  1679.            also reduces the trash buffer to twenty lines.                      
  1680.  
  1681.                                                                            p-36
  1682.          Housekeeping Details -------------------------------------------------
  1683.  
  1684.            RE  lets you edit any number of files at the same time  (subject  to
  1685.            memory limitations).  To add a  new file to those  being edited, use
  1686.            the E command.  To  move between  the  different  files  use  alt-q,
  1687.            f2-Next_session,  or f2-Previous_session.  To remove a file from the
  1688.            current files use the Q  command (if desired, use the  S command  to
  1689.            save the file first).
  1690.  
  1691.            Whenever RE scrolls to a specific line that  line is unexcluded.  If
  1692.            the  line is not on the screen then the  line and cursor  are put on
  1693.            the second line of the edit window.
  1694.  
  1695.            In order  to  prevent keyboard coasting, RE ignores certain repeated
  1696.            keystrokes when it cannot keep  up with them.  All  keys that invoke
  1697.            functions  (rather  than   text)   except   enter,  are  subject  to
  1698.            suppression.  Text is never suppressed.  If you are using a keyboard
  1699.            macro  program, put an  unused function  key (shift-f1 for  example)
  1700.            before each repeated function key to prevent suppression.  If you do
  1701.            not like the decoasting, see @DECOASTKB in REPROF.DOC. Some resident
  1702.            programs  that  take over  the  keyboard interrupt  can disable RE's
  1703.            keyboard decoasting.
  1704.  
  1705.            RE  displays the result of each keystroke, even if another keystroke
  1706.            is in  the  buffer  waiting to be  operated  on.  Together with  the
  1707.            keyboard decoasting system, this lets you use the typematic function
  1708.            of the keyboard without worrying about getting ahead of the display.
  1709.  
  1710.                                                                            p-37
  1711.          Mouse Handling -------------------------------------------------------
  1712.  
  1713.            RE has  native  mouse  handling  via the  Microsoft mouse  interface
  1714.            (interrupt hex  33).  You must install MOUSE.SYS or MOUSE.COM to get
  1715.            this  handling.  If  you  wish  to  use  a  mouse  driver that feeds
  1716.            keystrokes to  RE,  you will  probably need to  disable RE's  native
  1717.            mouse handling (see @MOUSE* in REPROF.DOC).
  1718.  
  1719.            The left  mouse button  is  the same as the enter key except that if
  1720.            there is no pending command, the Basic menu is displayed.  The right
  1721.            button  is the same as the esc key.  The middle button is unused but
  1722.            may be assigned. Mouse movement gives autoscroll cursor movement.
  1723.  
  1724.            If you get a two second delay on startup and after a DOS shell it is
  1725.            likely that your mouse hardware reset is causing this.  This happens
  1726.            on  some IBM  PS/2s.  On other systems  there may be a shorter,  but
  1727.            still annoying delay.  See @MOUSE* in REPROF.DOC to change the reset
  1728.            to a software reset.
  1729.  
  1730.          Displays -------------------------------------------------------------
  1731.  
  1732.            RE  has four  sets of display attributes.  These are: monochrome for
  1733.            use  on a digital  monochrome  display;  color  for use on  a  color
  1734.            display;  black/white  for use  on an analog monochrome display; and
  1735.            lcd for use on laptop computers. RE cannot set the display mode, but
  1736.            it  queries the  current mode on  startup  or  after a DOS shell and
  1737.            chooses its attribute set based on this.
  1738.  
  1739.            RE  can operate under text modes with 80 to 255  columns and 6 to 80
  1740.            lines.  The standard  modes  that  meet these requirements  are CO80
  1741.            (Color  80   column),  BW80  (Black/White   80   column),  and  MONO
  1742.            (Monochrome  80 column).  The mode  may  be set  with  the  DOS MODE
  1743.            command,  or other display  control software, before running  RE  or
  1744.            from a DOS shell.
  1745.  
  1746.            If you use a PC Convertible with  a liquid crystal display, set  the
  1747.            display mode to MONO or BW80 before starting RE.  RE will choose its
  1748.            lcd attributes instead of the normal mono or b/w attributes.  If you
  1749.            attach a color display, set the mode to CO80 to get the normal color
  1750.            attributes.
  1751.  
  1752.            RE can  detect the  use of  a PC  Convertible but  not  other laptop
  1753.            computers. To use the LCD attributes in this case, add the ^setatlcd
  1754.            command to the  startup macro in  your  profile and assemble it with
  1755.            REPROF (see REPROF.DOC).
  1756.  
  1757.            If you normally  use a color monitor  in black/white mode  then  the
  1758.            colors may not  be very good.  This  is  the default  situation on a
  1759.            PCjr.  To  fix  the  problem  add  the  line  "MODE  CO80"  to  your
  1760.            AUTOEXEC.BAT file.  This  requires  that the DOS file MODE.COM be on
  1761.            your boot disk.
  1762.  
  1763.            If you normally use an analog monochrome monitor in color mode, then
  1764.            the  colors will be poor.  This is the default situation with an IBM
  1765.            Portable PC and an IBM PS/2 or VGA with a monochrome monitor. To fix
  1766.            this problem add the line  "MODE BW80"  to  your AUTOEXEC.BAT  file.
  1767.            This requires that the DOS file MODE.COM be on your boot disk.      
  1768.  
  1769.                                                                            p-38
  1770.          Tips -----------------------------------------------------------------
  1771.  
  1772.            Here are a few tips that may help you with RE.
  1773.  
  1774.            If  you use the  DOS  shell often and you  have  enough memory,  put
  1775.            COMMAND.COM on a RAM disk, and "SET COMSPEC=D:\COMMAND.COM" in  your
  1776.            AUTOEXEC.BAT. DOS shells will run faster this way.
  1777.  
  1778.            If  you have a set of unequal length strings (one on each line) that
  1779.            need to be enclosed in quotes: put  a  one column block  mark to the
  1780.            left of  strings and fill  it with quotes  (use  f9-fill_block_pat);
  1781.            overlay the column of quotes to  the right  of the  strings (alt-o);
  1782.            extend the mark to the column to the  left  of  the new quotes  with
  1783.            f3-mark_column_resize and shift the strings to the right side of the
  1784.            mark  with f8-Right_side (or alt-v alt-v alt-v); extend  the mark to
  1785.            cover the right hand quotes with f3-mark_column_resize and shift the
  1786.            strings left with f8-Left_side.
  1787.  
  1788.              abcdef       'abcdef       'abcdef '       'abcdef'       'abcdef'
  1789.              abc     -->  'abc     -->  'abc    '  -->     'abc'  -->  'abc'
  1790.              abcd         'abcd         'abcd   '         'abcd'       'abcd'
  1791.  
  1792.            To transfer text between files: edit  both  files  at the same time;
  1793.            mark an area in one file; press alt-q to get to the second file; and
  1794.            then  move, copy, overlay or insert (alt-m, alt-c, alt-o, alt-i) the
  1795.            area mark.
  1796.  
  1797.            If  you  have  decided  where to move a piece of text, but  have not
  1798.            marked the text  yet,  press alt-p to mark  your position, then mark
  1799.            the text, and press alt-g to return to that position.
  1800.  
  1801.            It is rarely necessary to  unmark an area.  When you get  the  "Area
  1802.            mark already  exists" message, repeat the same function.  The unmark
  1803.            will be done automatically and the new area mark will be started.
  1804.  
  1805.            For cursor movement, shifting  text, inserting  new  lines,  and the
  1806.            repeat  find and change functions, the typematic  function of the PC
  1807.            keyboard is  very  useful.  RE prevents  keyboard coasting  on  such
  1808.            functions (not on text),  so generally you can  hold  a function key
  1809.            down until one more key press is needed. For a little practice, mark
  1810.            100 lines of a file, and use the shift left (alt-9) or right (alt-0)
  1811.            function.  If  you want to type ahead  on these keys, press shift-f1
  1812.            (or any unused function key) between each key.
  1813.  
  1814.            If you accidentally overwrite a  file with the  Save command, do not
  1815.            forget that this file is still on your disk, with extension BAK. You
  1816.            can exit RE and fix your  disk, or read  in the BAK file and save it
  1817.            to the correct name.
  1818.  
  1819.            It is wise to save your files to disk  often.  There are many events
  1820.            that can cause RE to lose data such as power failure, memory errors,
  1821.            and problems caused by resident DOS extensions. RE does no automatic
  1822.            backups.                                                            
  1823.  
  1824.                                                                            p-39
  1825.          Messages -------------------------------------------------------------
  1826.  
  1827.            RE displays messages in the first 25 columns of the status line.  In
  1828.            color  mode, informational messages are in  blue and error  messages
  1829.            are in red.  Critical error messages normally cause a  beep, but are
  1830.            silent on an immediate repeat.  A  few  of  the  messages may appear
  1831.            before the new DOS prompt when  RE  cannot be  run  or after  RE  is
  1832.            finished. The following is a list of messages.
  1833.  
  1834.            "Are you sure?  (Y/N)" is a request for you to confirm your command.
  1835.            Type "y" or "Y" to confirm.  Any other key cancels the command.  You
  1836.            can cause this message several ways.
  1837.  
  1838.              Do a  Quit  command  on a file  that you have changed but have not
  1839.              saved.
  1840.  
  1841.              Enter an ASCII decimal 26 as a  character.  This  character is the
  1842.              end  of  file  mark,  so  be  careful  where  you  put  it.   This
  1843.              confirmation is disabled if you patch in new style ASCII files.
  1844.  
  1845.              Do an area mark function immediately after receiving an "Area mark
  1846.              already  exists" or "Incorrect cursor position" message, or a line
  1847.              delete  when the mark is completely off of the screen.  It is then
  1848.              assumed that your area mark may not be as expected, and so you are
  1849.              asked for confirmation before the function is done.
  1850.  
  1851.              Do a flow  or right  justify function on a mark that  is  only one
  1852.              column wide.  This is presumed to be a mistake but it will be done
  1853.              if you confirm it.
  1854.  
  1855.              Do  an area  insert, overlay, or shift  that would  cause nonblank
  1856.              characters to be lost.  On destructive shifts, only the first of a
  1857.              series of identical shifts cause this prompt.
  1858.  
  1859.            "Area  mark  already exists" means  that you are trying to create an
  1860.            area mark  but one  already  exists.  If you immediately retry  your
  1861.            function then the area mark will be removed and the new one created.
  1862.            Or use alt-u to remove the current mark.
  1863.  
  1864.            "Cannot use display  mode" is seen  only on  a DOS screen.  It means
  1865.            that RE cannot work under the current display mode. The display must
  1866.            be in an alpha mode with between 80 and 255 columns. If you get this
  1867.            message after DOS shell, a new shell is  started and you must change
  1868.            the mode before going back to RE.
  1869.  
  1870.            "Changed"  tells  you that  your Change  command  or  repeat  change
  1871.            function is finished.  If the All,  Show all, or Hide all option was
  1872.            chosen and more than one string was changed,  the number of changes,
  1873.            up to 10000, is displayed.
  1874.  
  1875.            "Default disk/dir  changed" means  that you have changed the default
  1876.            disk or directory from a DOS shell.  This  may cause problems if you
  1877.            have not fully qualified your file names.
  1878.  
  1879.            "Defragmenting memory"  is a message that appears when a function is
  1880.            held up because RE is restructuring its internal database.          
  1881.  
  1882.                                                                            p-40
  1883.            "Disk/device  error"  means that RE has encountered a problem  while
  1884.            reading from or writing to a disk or device. This can be a directory
  1885.            space problem, a non-existant  drive  or device  (printer), a device
  1886.            error such  as a  printer  that is not ready, or  insufficient  disk
  1887.            space  on  a  Print  command  (Saves  check  for disk  space  before
  1888.            proceeding).
  1889.  
  1890.            "Disk write  protected"  means  that  your  Save  command has failed
  1891.            because the  disk  is  write  protected.  You  may  remove the write
  1892.            protect tape  on  the disk or insert a new disk and execute the Save
  1893.            command again.
  1894.  
  1895.            "DOS  error" usually means that on startup or after a DOS shell, DOS
  1896.            would not  let RE get  or recover its  memory.  This will  generally
  1897.            happen  only  when you  install  a resident  DOS extension from  the
  1898.            shell.  If you  get this  message, you will have  little or  no free
  1899.            memory  to work  with, and it  is  best to save your data and reboot
  1900.            your system.  If a DOS shell command fails  with message before  the
  1901.            shell  is  invoked,  it  means  that  RE could  not find the COMSPEC
  1902.            environment variable, which contains the location of the DOS command
  1903.            processor.
  1904.  
  1905.            "Drive not ready" means that  there is not a disk  in  the requested
  1906.            drive or that the door is not closed.
  1907.  
  1908.            "Enter ASCII code" is the prompt from the alt-a function.
  1909.  
  1910.            "Found" tells you that your Find command or repeat find  function is
  1911.            finished.  If the  All, Show all, or Hide all option  was chosen and
  1912.            more than one string was found, the number of finds, up to 10000, is
  1913.            displayed.
  1914.  
  1915.            "Free memory  (K)" tells you the amount of free memory, in kilobytes
  1916.            (1024  bytes).  This number is truncated  and so is usually a little
  1917.            less than the actual amount of available memory.
  1918.  
  1919.            "Free memory  low" means  that there is less than 2000 bytes of free
  1920.            memory. Certain functions will be disabled and give the insufficient
  1921.            free memory message. You can still do minimal editing, but beware of
  1922.            the memory full error message.
  1923.  
  1924.            "Incorrect Change string" means that the change string  in a  Change
  1925.            command or alt-2 (repeat change) function is not valid.
  1926.  
  1927.            "Incorrect  command" means that  the command that you  are trying to
  1928.            run is not recognized.
  1929.  
  1930.            "Incorrect cursor position" means that the cursor is in an incorrect
  1931.            position for the function that you are trying.
  1932.  
  1933.            "Incorrect file name" means that the file name that you specified in
  1934.            an  Edit,  Name, Print, or Save command  is not a valid file name or
  1935.            the file name in a Save command is not acceptable to RE  (files with
  1936.            extensions BAK, COM, EXE, RE!). See FILE NAMES.                     
  1937.  
  1938.                                                                            p-41
  1939.            "Incorrect Find string"  means  that  the  find string in a  Find or
  1940.            Change  command  or alt-1 (repeat find)  or  alt-2  (repeat  change)
  1941.            function is not valid.
  1942.  
  1943.            "Incorrect number" says that a number that you entered is not valid.
  1944.            For the alt-a function the number must be from 0 to 255 entered as a
  1945.            three digit number (with leading zeroes if needed). You can also get
  1946.            this message from a Tab, Wrap, or line number command.
  1947.  
  1948.            "Incorrect option" means that one of the options that you  specified
  1949.            in a command  is not  valid  or a pair of options conflict with each
  1950.            other (such as First  and Last).  This is  often a side effect  of a
  1951.            find or  change string  that includes  a blank but is not  delimited
  1952.            with quotes, or a missing blank after the command string.
  1953.  
  1954.            "Insert ?:, press enter" is a prompt  that  tells you to insert  the
  1955.            diskette that you are using as the ? disk (where ? can be A, B, ...)
  1956.            and then press enter to tell RE to continue.
  1957.  
  1958.            "Insufficient disk space"  means that  there  is not enough space on
  1959.            the disk to do the requested save.  You may want to use the D option
  1960.            on the Save command which uses a minimum of space.
  1961.  
  1962.            "Insufficient free  memory" means  that the available memory  is too
  1963.            low to do the requested function. The following functions require no
  1964.            memory: quit, save, blank area, and delete area.
  1965.  
  1966.            "Line(s)  split" means  that one  or  more lines were  split  at 255
  1967.            columns  during  file  input.  "Line(s)  too  long"  means  that  RE
  1968.            encountered a line  that would  exceed 255 columns if the  requested
  1969.            operation  was done.  For this line, the operation was not  done and
  1970.            the message is displayed. Some functions continue after encountering
  1971.            this problem (and may encounter another such line).
  1972.  
  1973.            "Mark is not in  session"  means  that you are  trying to do a Find,
  1974.            Change,  or  Print command with the M option (in area mark), but the
  1975.            area mark is in another file.
  1976.  
  1977.            "Mark is not in  window" means  that  you are  trying to change  the
  1978.            contents of  an area mark, but the  area mark is not in  the  active
  1979.            window.  This is not allowed in  general,  to help  avoid accidental
  1980.            changes.  For a  line  delete (alt-d  on  a line  area  mark) it  is
  1981.            allowed, but you are prompted for confirmation.
  1982.  
  1983.            "Memory full  -  Data Lost" means  that  RE  ran out of memory while
  1984.            executing a  function.  The function did  not complete and  the data
  1985.            needs to be fixed before saving the file.  This message is displayed
  1986.            when  RE cannot save the current line to the internal  database.  In
  1987.            this case changes to the line are removed.
  1988.  
  1989.            "No area mark" means  that you  are  trying  to do  a function  that
  1990.            requires an area mark, but none exists.
  1991.  
  1992.            "No files" means that your requested directory mask has no files.
  1993.  
  1994.            "No  mark" is displayed when you press alt-g (go to mark) but  there
  1995.            is no position mark or area mark.                                   
  1996.  
  1997.                                                                            p-42
  1998.            "Not found" means that your find string was not found.
  1999.  
  2000.            "Not in ring" says that the file that you are trying to go to is not
  2001.            in the current ring of files.
  2002.  
  2003.            "Numeric fill overflow"  means that your numeric  line fill function
  2004.            ran  out  of columns.  The  function was  completed, but is  missing
  2005.            digits to the left of the numbers.
  2006.  
  2007.            "Parameter too long" means that a command line  parameter exceeds 80
  2008.            characters, or 124 characters for a DOS command.
  2009.  
  2010.            "Press enter to continue" is given from  a DOS  shell when RE thinks
  2011.            that there is information on the screen that you may want to look at
  2012.            before you return to the RE screen.
  2013.  
  2014.            "Printed" means that  RE  has finished sending data to  the printer.
  2015.            (The printer may still be working on the job.)
  2016.  
  2017.            "Replace file?  (Y/N)" means that your Save or Print command (with a
  2018.            file explicitly specified) will overwrite a file and you  must press
  2019.            "Y" to  continue the operation.  For Saves, this prompt will only be
  2020.            given for the D and I save types. With the B (default) save type, an
  2021.            overwritten file may be recovered from the .BAK file.
  2022.  
  2023.            "Saved" says that your data was successfully saved.
  2024.  
  2025.            "Saved  - file replaced" says that your data  was successfully saved
  2026.            to  a non-default file name which was already on the  disk.  The old
  2027.            file was renamed with the .BAK extension.                           
  2028.  
  2029.                                                                            p-43
  2030.          RBIN -----------------------------------------------------------------
  2031.  
  2032.            RBIN is a utility that works only from within Ravitz Editor. It lets
  2033.            you edit  binary files, such as .COM, .EXE, font, or printer control
  2034.            files,  with RE.  It is also useful to  look at files  as is, before
  2035.            tab, CR/LF, and EOF characters are processed.  To do this, RBIN must
  2036.            do the file loading and saving.
  2037.  
  2038.            To load  a file, use the command "DM RBIN filename".  This loads the
  2039.            file  with 64  bytes on a line  followed by an  ASCII 179  (vertical
  2040.            bar).  The last line may have less  than  64 bytes.  "DM RBIN reclen
  2041.            filename" loads the file with reclen (1..254) bytes on a line.
  2042.  
  2043.            Once you have loaded a  file,  you  have  complete  use  of  all  RE
  2044.            functions.  The Find  command cannot  find  a  string that  is split
  2045.            across lines, so do not rely on finds.
  2046.  
  2047.            Before saving  the file, each  line must end with an ASCII 179,  but
  2048.            there are no line  length restrictions, so  you may insert or delete
  2049.            characters in any line. To save the file, use the command "DM RBIN S
  2050.            (filename)".  The file name is optional.  To save  and quit, use "DM
  2051.            RBIN SQ (filename)".  All saves are done directly to  the default or
  2052.            specified file, without checking for available disk space.
  2053.  
  2054.            The 64 byte default record length may be patched to any number under
  2055.            255.  To  change  the  number to 16 bytes, run the command "dm  rbin
  2056.            rbin.exe".  Scroll to the bottom  and  look for the  string "default
  2057.            record length byte:". Change the "@" to ASCII 016 (alt-a 0 1 6), and
  2058.            save the file with "dm rbin s".
  2059.  
  2060.            LIMITATIONS
  2061.  
  2062.              The  RE  find/change facility cannot  find strings  that cross the
  2063.              RBIN line breaks.
  2064.  
  2065.              File output does no disk space checking.                          
  2066.  
  2067.                                                                            p-44
  2068.          Compatibility and Technical Information ------------------------------
  2069.  
  2070.            RE will run on any IBM compatible MS-DOS computer, with an 80 column
  2071.            (or greater)  monitor, in  a  memory space of  96K (or less for very
  2072.            small files).  RE  supports being  windowed by DESQview  but  not by
  2073.            Windows.
  2074.  
  2075.            RE reads  and  writes standard  ASCII text  files.  For a file to be
  2076.            properly read,  it  must have a CR/LF (hex 0D and 0A, in that order)
  2077.            at the end of each line except the last. EOF (hex 1A) is viewed as a
  2078.            file terminator  but is not required.  By default tab characters are
  2079.            expanded on input. The maximum line length is 255 characters. When a
  2080.            file is written, CR/LF is put at the end of each line including  the
  2081.            last, and EOF is put at the end of the file.  By default there is no
  2082.            tab  compression on output.  All trailing blanks  on  each line  are
  2083.            removed when writing a file.
  2084.  
  2085.            If  RE is modified to work  with  new  style ASCII text  files  (see
  2086.            @FILETP in REPROF.DOC) then EOF is not  viewed as  a file terminator
  2087.            and when writing a file, the final CR/LF/EOF is left off.
  2088.  
  2089.            RE uses BIOS functions  for the display interface except that screen
  2090.            updates are done by writing directly to the display buffer. If color
  2091.            screen update waits are in effect, port hex 3DA is polled.  RE looks
  2092.            for DESQview and, if found, uses the DESQview selected screen buffer
  2093.            and forces  immediate screen updates.  RE finds the display mode and
  2094.            screen size by calling BIOS interrupt hex 10.  The display mode must
  2095.            be a memory mapped text mode with  active page 0.  This is tested by
  2096.            writing  to position 0,0 with BIOS and checking that memory location
  2097.            directly. The number of columns must be from 80 to 255.  At least 10
  2098.            lines are required but this is not checked.  25 lines are needed  to
  2099.            fully display the  default help text  and no more  than 80 lines are
  2100.            ever used.  To run under Windows you must have Windows invoke a text
  2101.            mode.  RE  never  changes  the  display  mode, active  page, or BIOS
  2102.            colors.
  2103.  
  2104.            BIOS functions  are  used for the  keyboard interface.  RE  normally
  2105.            polls the keyboard (see the  @POLLINPUT in REPROF.DOC).  Unused time
  2106.            slices  are returned to DESQview.  By default  the enhanced keyboard
  2107.            functions are not used, but they are available (see @ENHANCEDKB).
  2108.  
  2109.            The Microsoft mouse interface (interrupt hex 33)  is  used for mouse
  2110.            handling. Functions 0 or hex 21 for reset, 3 for button presses, and
  2111.            hex B for motion are the only functions used.
  2112.  
  2113.            All other  input and  output is done  with  DOS  2.0  extended  file
  2114.            management functions, in binary mode if writing to a device.
  2115.  
  2116.            Interrupts hex  1B (BIOS break  key handler), hex 23  (DOS break key
  2117.            handler),  and hex 24 (DOS critical error  handler)  are  taken over
  2118.            when RE  is started from  DOS or a  DOS shell, and  restored  before
  2119.            returning to DOS or  a  DOS shell.  This  is  done with DOS function
  2120.            calls. No other interrupts are taken.
  2121.  
  2122.            The system clock (address hex 0040:006C) is read directly.          
  2123.  
  2124.                                                                            p-45
  2125.            RE uses only memory below 1024K.  Except as noted here, RE  does not
  2126.            use extended or expanded  memory or a spill file.  All of DOS memory
  2127.            is used (up to 736K).  Quarterdeck's VIDRAM, included with QEMM 386,
  2128.            converts EGA/VGA video memory to standard DOS memory, and RE can use
  2129.            this.
  2130.  
  2131.            If available, RE uses 4 pages (64K) of  EMS memory, accessed through
  2132.            interrupt hex 67, functions  hex 40, 41,  43, 44, 45.  The memory is
  2133.            remapped after each DOS shell, so programs in the shell can use EMS.
  2134.            This can be disabled (see @nondosmem).
  2135.  
  2136.            RE looks  for  an  XMS  handler  (HIMEM.SYS/EMM386.EXE,  386MAX.SYS,
  2137.            QEMM.SYS),  with interrupt hex 2F functions hex 0 and 10.  If found,
  2138.            RE takes  up  to four  upper memory blocks,  of at  least 4K,  using
  2139.            functions hex 10 and 11. This memory is not available to DOS shells.
  2140.            This can be disabled (see @nondosmem). If no XMS upper memory blocks
  2141.            are found and  DOS is level 5.0 or greater, then RE  will take up to
  2142.            to four DOS upper memory blocks instead, using functions hex  58 and
  2143.            48.
  2144.  
  2145.            RE uses non-DOS memory  (EMS, XMS UMB, DOS  UMB)  preferentially, so
  2146.            that DOS shells have maximum memory.
  2147.  
  2148.            With DOS 3.1 or lower, when you use one diskette drive as A: and B:,
  2149.            RE reads and  writes to the DOS Communication Area single drive mode
  2150.            status byte (address hex 0050:0004).
  2151.  
  2152.            RE  does a number things to help it work  better when running  under
  2153.            DESQview.  Although RE polls  the keyboard,  unused  time slices are
  2154.            returned to DV, so  background tasks work well.  RE writes to the DV
  2155.            selected screen buffer and forces  screen updates with interrupt hex
  2156.            10  function  hex  FF.  This  gives good windowing and clean  screen
  2157.            updates.  When under DV,  the  BIOS cursor  tracks  the  nonblinking
  2158.            cursor  or the menu bar cursor.  This lets DV keep the right part of
  2159.            the screen  displayed.  If you  keep at least forty  columns  in the
  2160.            window, the current menu choice will always be completely visible.
  2161.  
  2162.            Some  old  versions of DESQview,  when  invoked with XDV,  use upper
  2163.            memory blocks without allocating them through XMS.  This will  clash
  2164.            with  RE,  unless  you  disable  RE's   XMS  memory  handling   (see
  2165.            @nondosmem). DV 2.25 handles this correctly.
  2166.  
  2167.            RE.EXE and  REPROF.EXE may be  compressed with EXE  file compressors
  2168.            such as PKLITE and  LZEXE,  but  be  aware  that when  installing  a
  2169.            profile, REPROF generates a completely new and uncompressed RE.EXE.
  2170.  
  2171.            RE was written  by Cary Ravitz  and  compiled with  Borland's  Turbo
  2172.            Pascal 6.0 and  Turbo Assembler 2.0, but  does  not  use  the  Turbo
  2173.            Pascal library or startup code.                                     
  2174.  
  2175.                                                                            p-46
  2176.          What RE Cannot Do ----------------------------------------------------
  2177.  
  2178.            RE  cannot do certain things that you might want it  to.  Here is  a
  2179.            list of some of these:
  2180.  
  2181.              use virtual memory management (spill file, expanded memory)
  2182.  
  2183.              handle lines greater than 255 characters
  2184.  
  2185.              string marks  - all area marks are rectangular (Use  split/join to
  2186.              help with string moves.)
  2187.  
  2188.              have more than two windows
  2189.  
  2190.              screen split other than one horizontal split
  2191.  
  2192.              different lines excluded in the same file in different windows
  2193.                (But check out the save and restore excluded lines functions.)
  2194.  
  2195.              preserve trailing blanks when saving
  2196.  
  2197.              run in graphics screen modes                                      
  2198.  
  2199.                                                                            p-47
  2200.          User Support ---------------------------------------------------------
  2201.  
  2202.            Correspondence  about  this  program  may be  sent  via the  support
  2203.            bulletin board, fax, Compuserve, or mail.
  2204.  
  2205.            BBS:        606-268-0577  1200..14400,N,8,1  24 hours/day
  2206.  
  2207.              To ask a question, prepare an ASCII  text file with the details of
  2208.              your question.  Then call the bulletin board and choose the upload
  2209.              question option.  XMODEM  file  transfer protocol is  required for
  2210.              this.  Your question will  be assigned a number (such  as  1015) -
  2211.              remember  this  number.  An answer file (with the assigned number)
  2212.              will  be posted, usually  within 24 hours on  weekdays.  To get an
  2213.              answer, call the bulletin board,  choose the download option, then
  2214.              the answer option, and then enter the answer number.
  2215.  
  2216.            Compuserve: Cary Ravitz [70431,32]
  2217.  
  2218.            Fax:        606-268-0577
  2219.  
  2220.              If  your fax machine does not send the fax calling signal, the BBS
  2221.              will  answer and  hang  up (about  30  seconds), then the  call is
  2222.              routed to the fax.  Faxes from outside the USA may be answered via
  2223.              letter. The fax may be unavailable sometimes.
  2224.  
  2225.            Mail:       Ravitz Software Inc.
  2226.                        P.O. Box 25068
  2227.                        Lexington, KY  40524-5068
  2228.                        USA